/ Hex Artifact Content
Login

Artifact d3c6f28dbf462187f3fd696f2357e0d23940abac:


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 2a 0a 2a 2a 20 24 49 64 3a 20 76 64  E..**.** $Id: vd
01d0: 62 65 61 70 69 2e 63 2c 76 20 31 2e 31 35 39 20  beapi.c,v 1.159 
01e0: 32 30 30 39 2f 30 34 2f 30 39 20 31 34 3a 30 32  2009/04/09 14:02
01f0: 3a 34 34 20 64 72 68 20 45 78 70 20 24 0a 2a 2f  :44 drh Exp $.*/
0200: 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74  .#include "sqlit
0210: 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65  eInt.h".#include
0220: 20 22 76 64 62 65 49 6e 74 2e 68 22 0a 0a 23 69   "vdbeInt.h"..#i
0230: 66 20 30 20 26 26 20 64 65 66 69 6e 65 64 28 53  f 0 && defined(S
0240: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
0250: 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29 0a  ORY_MANAGEMENT).
0260: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  /*.** The follow
0270: 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 63 6f  ing structure co
0280: 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72 73 20  ntains pointers 
0290: 74 6f 20 74 68 65 20 65 6e 64 20 70 6f 69 6e 74  to the end point
02a0: 73 20 6f 66 20 61 0a 2a 2a 20 64 6f 75 62 6c 79  s of a.** doubly
02b0: 2d 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20  -linked list of 
02c0: 61 6c 6c 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c  all compiled SQL
02d0: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
02e0: 20 6d 61 79 20 62 65 20 68 6f 6c 64 69 6e 67 0a   may be holding.
02f0: 2a 2a 20 62 75 66 66 65 72 73 20 65 6c 69 67 69  ** buffers eligi
0300: 62 6c 65 20 66 6f 72 20 72 65 6c 65 61 73 65 20  ble for release 
0310: 77 68 65 6e 20 74 68 65 20 73 71 6c 69 74 65 33  when the sqlite3
0320: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28  _release_memory(
0330: 29 20 69 6e 74 65 72 66 61 63 65 20 69 73 0a 2a  ) interface is.*
0340: 2a 20 69 6e 76 6f 6b 65 64 2e 20 41 63 63 65 73  * invoked. Acces
0350: 73 20 74 6f 20 74 68 69 73 20 6c 69 73 74 20 69  s to this list i
0360: 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 74  s protected by t
0370: 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  he SQLITE_MUTEX_
0380: 53 54 41 54 49 43 5f 4c 52 55 32 0a 2a 2a 20 6d  STATIC_LRU2.** m
0390: 75 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74  utex..**.** Stat
03a0: 65 6d 65 6e 74 73 20 61 72 65 20 61 64 64 65 64  ements are added
03b0: 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74   to the end of t
03c0: 68 69 73 20 6c 69 73 74 20 77 68 65 6e 20 73 71  his list when sq
03d0: 6c 69 74 65 33 5f 72 65 73 65 74 28 29 20 69 73  lite3_reset() is
03e0: 0a 2a 2a 20 63 61 6c 6c 65 64 2e 20 54 68 65 79  .** called. They
03f0: 20 61 72 65 20 72 65 6d 6f 76 65 64 20 65 69 74   are removed eit
0400: 68 65 72 20 77 68 65 6e 20 73 71 6c 69 74 65 33  her when sqlite3
0410: 5f 73 74 65 70 28 29 20 6f 72 20 73 71 6c 69 74  _step() or sqlit
0420: 65 33 5f 66 69 6e 61 6c 69 7a 65 28 29 0a 2a 2a  e3_finalize().**
0430: 20 69 73 20 63 61 6c 6c 65 64 2e 20 57 68 65 6e   is called. When
0440: 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20   statements are 
0450: 61 64 64 65 64 20 74 6f 20 74 68 69 73 20 6c 69  added to this li
0460: 73 74 2c 20 74 68 65 20 61 73 73 6f 63 69 61 74  st, the associat
0470: 65 64 20 0a 2a 2a 20 72 65 67 69 73 74 65 72 20  ed .** register 
0480: 61 72 72 61 79 20 28 70 2d 3e 61 4d 65 6d 5b 31  array (p->aMem[1
0490: 2e 2e 70 2d 3e 6e 4d 65 6d 5d 29 20 6d 61 79 20  ..p->nMem]) may 
04a0: 63 6f 6e 74 61 69 6e 20 64 79 6e 61 6d 69 63 20  contain dynamic 
04b0: 62 75 66 66 65 72 73 20 74 68 61 74 0a 2a 2a 20  buffers that.** 
04c0: 63 61 6e 20 62 65 20 66 72 65 65 64 20 75 73 69  can be freed usi
04d0: 6e 67 20 73 71 6c 69 74 65 33 56 64 62 65 52 65  ng sqlite3VdbeRe
04e0: 6c 65 61 73 65 4d 65 6d 6f 72 79 28 29 2e 0a 2a  leaseMemory()..*
04f0: 2a 0a 2a 2a 20 57 68 65 6e 20 73 74 61 74 65 6d  *.** When statem
0500: 65 6e 74 73 20 61 72 65 20 61 64 64 65 64 20 6f  ents are added o
0510: 72 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74  r removed from t
0520: 68 69 73 20 6c 69 73 74 2c 20 74 68 65 20 6d 75  his list, the mu
0530: 74 65 78 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65  tex.** associate
0540: 64 20 77 69 74 68 20 74 68 65 20 56 64 62 65 20  d with the Vdbe 
0550: 62 65 69 6e 67 20 61 64 64 65 64 20 6f 72 20 72  being added or r
0560: 65 6d 6f 76 65 64 20 28 56 64 62 65 2e 64 62 2d  emoved (Vdbe.db-
0570: 3e 6d 75 74 65 78 29 20 69 73 0a 2a 2a 20 61 6c  >mutex) is.** al
0580: 72 65 61 64 79 20 68 65 6c 64 2e 20 54 68 65 20  ready held. The 
0590: 4c 52 55 32 20 6d 75 74 65 78 20 69 73 20 74 68  LRU2 mutex is th
05a0: 65 6e 20 6f 62 74 61 69 6e 65 64 2c 20 62 6c 6f  en obtained, blo
05b0: 63 6b 69 6e 67 20 69 66 20 6e 65 63 65 73 73 61  cking if necessa
05c0: 72 79 2c 0a 2a 2a 20 74 68 65 20 6c 69 6e 6b 65  ry,.** the linke
05d0: 64 2d 6c 69 73 74 20 70 6f 69 6e 74 65 72 73 20  d-list pointers 
05e0: 6d 61 6e 69 70 75 6c 61 74 65 64 20 61 6e 64 20  manipulated and 
05f0: 74 68 65 20 4c 52 55 32 20 6d 75 74 65 78 20 72  the LRU2 mutex r
0600: 65 6c 69 6e 71 75 69 73 68 65 64 2e 0a 2a 2f 0a  elinquished..*/.
0610: 73 74 72 75 63 74 20 53 74 61 74 65 6d 65 6e 74  struct Statement
0620: 4c 72 75 4c 69 73 74 20 7b 0a 20 20 56 64 62 65  LruList {.  Vdbe
0630: 20 2a 70 46 69 72 73 74 3b 0a 20 20 56 64 62 65   *pFirst;.  Vdbe
0640: 20 2a 70 4c 61 73 74 3b 0a 7d 3b 0a 73 74 61 74   *pLast;.};.stat
0650: 69 63 20 73 74 72 75 63 74 20 53 74 61 74 65 6d  ic struct Statem
0660: 65 6e 74 4c 72 75 4c 69 73 74 20 73 71 6c 69 74  entLruList sqlit
0670: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 3b  e3LruStatements;
0680: 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68  ../*.** Check th
0690: 61 74 20 74 68 65 20 6c 69 73 74 20 6c 6f 6f 6b  at the list look
06a0: 73 20 74 6f 20 62 65 20 69 6e 74 65 72 6e 61 6c  s to be internal
06b0: 6c 79 20 63 6f 6e 73 69 73 74 65 6e 74 2e 20 54  ly consistent. T
06c0: 68 69 73 20 69 73 20 75 73 65 64 0a 2a 2a 20 61  his is used.** a
06d0: 73 20 70 61 72 74 20 6f 66 20 61 6e 20 61 73 73  s part of an ass
06e0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 20  ert() statement 
06f0: 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a  as follows:.**.*
0700: 2a 20 20 20 61 73 73 65 72 74 28 20 73 74 6d 74  *   assert( stmt
0710: 4c 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 2a 2f  LruCheck() );.*/
0720: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a  .#ifndef NDEBUG.
0730: 73 74 61 74 69 63 20 69 6e 74 20 73 74 6d 74 4c  static int stmtL
0740: 72 75 43 68 65 63 6b 28 29 7b 0a 20 20 56 64 62  ruCheck(){.  Vdb
0750: 65 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 73 71  e *p;.  for(p=sq
0760: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0770: 74 73 2e 70 46 69 72 73 74 3b 20 70 3b 20 70 3d  ts.pFirst; p; p=
0780: 70 2d 3e 70 4c 72 75 4e 65 78 74 29 7b 0a 20 20  p->pLruNext){.  
0790: 20 20 61 73 73 65 72 74 28 70 2d 3e 70 4c 72 75    assert(p->pLru
07a0: 4e 65 78 74 20 7c 7c 20 70 3d 3d 73 71 6c 69 74  Next || p==sqlit
07b0: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
07c0: 70 4c 61 73 74 29 3b 0a 20 20 20 20 61 73 73 65  pLast);.    asse
07d0: 72 74 28 21 70 2d 3e 70 4c 72 75 4e 65 78 74 20  rt(!p->pLruNext 
07e0: 7c 7c 20 70 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e  || p->pLruNext->
07f0: 70 4c 72 75 50 72 65 76 3d 3d 70 29 3b 0a 20 20  pLruPrev==p);.  
0800: 20 20 61 73 73 65 72 74 28 70 2d 3e 70 4c 72 75    assert(p->pLru
0810: 50 72 65 76 20 7c 7c 20 70 3d 3d 73 71 6c 69 74  Prev || p==sqlit
0820: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
0830: 70 46 69 72 73 74 29 3b 0a 20 20 20 20 61 73 73  pFirst);.    ass
0840: 65 72 74 28 21 70 2d 3e 70 4c 72 75 50 72 65 76  ert(!p->pLruPrev
0850: 20 7c 7c 20 70 2d 3e 70 4c 72 75 50 72 65 76 2d   || p->pLruPrev-
0860: 3e 70 4c 72 75 4e 65 78 74 3d 3d 70 29 3b 0a 20  >pLruNext==p);. 
0870: 20 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d   }.  return 1;.}
0880: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41  .#endif../*.** A
0890: 64 64 20 76 64 62 65 20 70 20 74 6f 20 74 68 65  dd vdbe p to the
08a0: 20 65 6e 64 20 6f 66 20 74 68 65 20 73 74 61 74   end of the stat
08b0: 65 6d 65 6e 74 20 6c 72 75 20 6c 69 73 74 2e 20  ement lru list. 
08c0: 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68  It is assumed th
08d0: 61 74 0a 2a 2a 20 70 20 69 73 20 6e 6f 74 20 61  at.** p is not a
08e0: 6c 72 65 61 64 79 20 70 61 72 74 20 6f 66 20 74  lready part of t
08f0: 68 65 20 6c 69 73 74 20 77 68 65 6e 20 74 68 69  he list when thi
0900: 73 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65  s is called. The
0910: 20 6c 72 75 20 6c 69 73 74 0a 2a 2a 20 69 73 20   lru list.** is 
0920: 70 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65  protected by the
0930: 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54   SQLITE_MUTEX_ST
0940: 41 54 49 43 5f 4c 52 55 20 6d 75 74 65 78 2e 0a  ATIC_LRU mutex..
0950: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73  */.static void s
0960: 74 6d 74 4c 72 75 41 64 64 28 56 64 62 65 20 2a  tmtLruAdd(Vdbe *
0970: 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75  p){.  sqlite3_mu
0980: 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 65  tex_enter(sqlite
0990: 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49  3MutexAlloc(SQLI
09a0: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f  TE_MUTEX_STATIC_
09b0: 4c 52 55 32 29 29 3b 0a 0a 20 20 69 66 28 20 70  LRU2));..  if( p
09c0: 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 2d  ->pLruPrev || p-
09d0: 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 73 71 6c  >pLruNext || sql
09e0: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74  ite3LruStatement
09f0: 73 2e 70 46 69 72 73 74 3d 3d 70 20 29 7b 0a 20  s.pFirst==p ){. 
0a00: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
0a10: 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 4d 75  _leave(sqlite3Mu
0a20: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
0a30: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
0a40: 32 29 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b  2));.    return;
0a50: 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20  .  }..  assert( 
0a60: 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29 20 29  stmtLruCheck() )
0a70: 3b 0a 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65  ;..  if( !sqlite
0a80: 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70  3LruStatements.p
0a90: 46 69 72 73 74 20 29 7b 0a 20 20 20 20 61 73 73  First ){.    ass
0aa0: 65 72 74 28 20 21 73 71 6c 69 74 65 33 4c 72 75  ert( !sqlite3Lru
0ab0: 53 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74  Statements.pLast
0ac0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4c   );.    sqlite3L
0ad0: 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 46 69  ruStatements.pFi
0ae0: 72 73 74 20 3d 20 70 3b 0a 20 20 20 20 73 71 6c  rst = p;.    sql
0af0: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74  ite3LruStatement
0b00: 73 2e 70 4c 61 73 74 20 3d 20 70 3b 0a 20 20 7d  s.pLast = p;.  }
0b10: 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74  else{.    assert
0b20: 28 20 21 73 71 6c 69 74 65 33 4c 72 75 53 74 61  ( !sqlite3LruSta
0b30: 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 2d 3e 70  tements.pLast->p
0b40: 4c 72 75 4e 65 78 74 20 29 3b 0a 20 20 20 20 70  LruNext );.    p
0b50: 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 73 71 6c  ->pLruPrev = sql
0b60: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74  ite3LruStatement
0b70: 73 2e 70 4c 61 73 74 3b 0a 20 20 20 20 73 71 6c  s.pLast;.    sql
0b80: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74  ite3LruStatement
0b90: 73 2e 70 4c 61 73 74 2d 3e 70 4c 72 75 4e 65 78  s.pLast->pLruNex
0ba0: 74 20 3d 20 70 3b 0a 20 20 20 20 73 71 6c 69 74  t = p;.    sqlit
0bb0: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
0bc0: 70 4c 61 73 74 20 3d 20 70 3b 0a 20 20 7d 0a 0a  pLast = p;.  }..
0bd0: 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72    assert( stmtLr
0be0: 75 43 68 65 63 6b 28 29 20 29 3b 0a 0a 20 20 73  uCheck() );..  s
0bf0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
0c00: 76 65 28 73 71 6c 69 74 65 33 4d 75 74 65 78 41  ve(sqlite3MutexA
0c10: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45  lloc(SQLITE_MUTE
0c20: 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 29 29 3b  X_STATIC_LRU2));
0c30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d 69  .}../*.** Assumi
0c40: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 55  ng the SQLITE_MU
0c50: 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 20  TEX_STATIC_LRU2 
0c60: 6d 75 74 65 78 74 20 69 73 20 61 6c 72 65 61 64  mutext is alread
0c70: 79 20 68 65 6c 64 2c 20 72 65 6d 6f 76 65 0a 2a  y held, remove.*
0c80: 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 20 66 72  * statement p fr
0c90: 6f 6d 20 74 68 65 20 6c 65 61 73 74 2d 72 65 63  om the least-rec
0ca0: 65 6e 74 6c 79 2d 75 73 65 64 20 73 74 61 74 65  ently-used state
0cb0: 6d 65 6e 74 20 6c 69 73 74 2e 20 49 66 20 74 68  ment list. If th
0cc0: 65 20 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20  e .** statement 
0cd0: 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79  is not currently
0ce0: 20 70 61 72 74 20 6f 66 20 74 68 65 20 6c 69 73   part of the lis
0cf0: 74 2c 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20  t, this call is 
0d00: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74  a no-op..*/.stat
0d10: 69 63 20 76 6f 69 64 20 73 74 6d 74 4c 72 75 52  ic void stmtLruR
0d20: 65 6d 6f 76 65 4e 6f 6d 75 74 65 78 28 56 64 62  emoveNomutex(Vdb
0d30: 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e  e *p){.  if( p->
0d40: 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 2d 3e 70  pLruPrev || p->p
0d50: 4c 72 75 4e 65 78 74 20 7c 7c 20 70 3d 3d 73 71  LruNext || p==sq
0d60: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0d70: 74 73 2e 70 46 69 72 73 74 20 29 7b 0a 20 20 20  ts.pFirst ){.   
0d80: 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72 75   assert( stmtLru
0d90: 43 68 65 63 6b 28 29 20 29 3b 0a 20 20 20 20 69  Check() );.    i
0da0: 66 28 20 70 2d 3e 70 4c 72 75 4e 65 78 74 20 29  f( p->pLruNext )
0db0: 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4c 72 75 4e  {.      p->pLruN
0dc0: 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20  ext->pLruPrev = 
0dd0: 70 2d 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 20  p->pLruPrev;.   
0de0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71   }else{.      sq
0df0: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0e00: 74 73 2e 70 4c 61 73 74 20 3d 20 70 2d 3e 70 4c  ts.pLast = p->pL
0e10: 72 75 50 72 65 76 3b 0a 20 20 20 20 7d 0a 20 20  ruPrev;.    }.  
0e20: 20 20 69 66 28 20 70 2d 3e 70 4c 72 75 50 72 65    if( p->pLruPre
0e30: 76 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4c  v ){.      p->pL
0e40: 72 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78 74  ruPrev->pLruNext
0e50: 20 3d 20 70 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a   = p->pLruNext;.
0e60: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
0e70: 20 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65   sqlite3LruState
0e80: 6d 65 6e 74 73 2e 70 46 69 72 73 74 20 3d 20 70  ments.pFirst = p
0e90: 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 20 20  ->pLruNext;.    
0ea0: 7d 0a 20 20 20 20 70 2d 3e 70 4c 72 75 4e 65 78  }.    p->pLruNex
0eb0: 74 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 70 4c  t = 0;.    p->pL
0ec0: 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 20  ruPrev = 0;.    
0ed0: 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72 75 43  assert( stmtLruC
0ee0: 68 65 63 6b 28 29 20 29 3b 0a 20 20 7d 0a 7d 0a  heck() );.  }.}.
0ef0: 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d 69 6e 67 20  ./*.** Assuming 
0f00: 74 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  the SQLITE_MUTEX
0f10: 5f 53 54 41 54 49 43 5f 4c 52 55 32 20 6d 75 74  _STATIC_LRU2 mut
0f20: 65 78 74 20 69 73 20 6e 6f 74 20 68 65 6c 64 2c  ext is not held,
0f30: 20 72 65 6d 6f 76 65 0a 2a 2a 20 73 74 61 74 65   remove.** state
0f40: 6d 65 6e 74 20 70 20 66 72 6f 6d 20 74 68 65 20  ment p from the 
0f50: 6c 65 61 73 74 2d 72 65 63 65 6e 74 6c 79 2d 75  least-recently-u
0f60: 73 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6c 69  sed statement li
0f70: 73 74 2e 20 49 66 20 74 68 65 20 0a 2a 2a 20 73  st. If the .** s
0f80: 74 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f 74 20  tatement is not 
0f90: 63 75 72 72 65 6e 74 6c 79 20 70 61 72 74 20 6f  currently part o
0fa0: 66 20 74 68 65 20 6c 69 73 74 2c 20 74 68 69 73  f the list, this
0fb0: 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70   call is a no-op
0fc0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
0fd0: 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76 65 28 56   stmtLruRemove(V
0fe0: 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74  dbe *p){.  sqlit
0ff0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73  e3_mutex_enter(s
1000: 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63  qlite3MutexAlloc
1010: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54  (SQLITE_MUTEX_ST
1020: 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 20 20 73  ATIC_LRU2));.  s
1030: 74 6d 74 4c 72 75 52 65 6d 6f 76 65 4e 6f 6d 75  tmtLruRemoveNomu
1040: 74 65 78 28 70 29 3b 0a 20 20 73 71 6c 69 74 65  tex(p);.  sqlite
1050: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71  3_mutex_leave(sq
1060: 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28  lite3MutexAlloc(
1070: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
1080: 54 49 43 5f 4c 52 55 32 29 29 3b 0a 7d 0a 0a 2f  TIC_LRU2));.}../
1090: 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 72 65 6c 65  *.** Try to rele
10a0: 61 73 65 20 6e 20 62 79 74 65 73 20 6f 66 20 6d  ase n bytes of m
10b0: 65 6d 6f 72 79 20 62 79 20 66 72 65 65 69 6e 67  emory by freeing
10c0: 20 62 75 66 66 65 72 73 20 61 73 73 6f 63 69 61   buffers associa
10d0: 74 65 64 20 0a 2a 2a 20 77 69 74 68 20 74 68 65  ted .** with the
10e0: 20 6d 65 6d 6f 72 79 20 72 65 67 69 73 74 65 72   memory register
10f0: 73 20 6f 66 20 63 75 72 72 65 6e 74 6c 79 20 75  s of currently u
1100: 6e 75 73 65 64 20 76 64 62 65 73 2e 0a 2a 2f 0a  nused vdbes..*/.
1110: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 52  int sqlite3VdbeR
1120: 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74  eleaseMemory(int
1130: 20 6e 29 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a   n){.  Vdbe *p;.
1140: 20 20 56 64 62 65 20 2a 70 4e 65 78 74 3b 0a 20    Vdbe *pNext;. 
1150: 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30 3b 0a   int nFree = 0;.
1160: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
1170: 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 4d 75  _enter(sqlite3Mu
1180: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
1190: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
11a0: 32 29 29 3b 0a 20 20 66 6f 72 28 70 3d 73 71 6c  2));.  for(p=sql
11b0: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74  ite3LruStatement
11c0: 73 2e 70 46 69 72 73 74 3b 20 70 20 26 26 20 6e  s.pFirst; p && n
11d0: 46 72 65 65 3c 6e 3b 20 70 3d 70 4e 65 78 74 29  Free<n; p=pNext)
11e0: 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d  {.    pNext = p-
11f0: 3e 70 4c 72 75 4e 65 78 74 3b 0a 0a 20 20 20 20  >pLruNext;..    
1200: 2f 2a 20 46 6f 72 20 65 61 63 68 20 73 74 61 74  /* For each stat
1210: 65 6d 65 6e 74 20 68 61 6e 64 6c 65 20 69 6e 20  ement handle in 
1220: 74 68 65 20 6c 72 75 20 6c 69 73 74 2c 20 61 74  the lru list, at
1230: 74 65 6d 70 74 20 74 6f 20 6f 62 74 61 69 6e 20  tempt to obtain 
1240: 74 68 65 0a 20 20 20 20 2a 2a 20 61 73 73 6f 63  the.    ** assoc
1250: 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 6d  iated database m
1260: 75 74 65 78 2e 20 49 66 20 69 74 20 63 61 6e 6e  utex. If it cann
1270: 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 2c 20  ot be obtained, 
1280: 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20 2a 2a 20  continue.    ** 
1290: 74 6f 20 74 68 65 20 6e 65 78 74 20 73 74 61 74  to the next stat
12a0: 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 20 49 74  ement handle. It
12b0: 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65   is not possible
12c0: 20 74 6f 20 62 6c 6f 63 6b 20 6f 6e 0a 20 20 20   to block on.   
12d0: 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65   ** the database
12e0: 20 6d 75 74 65 78 20 2d 20 74 68 61 74 20 63 6f   mutex - that co
12f0: 75 6c 64 20 63 61 75 73 65 20 64 65 61 64 6c 6f  uld cause deadlo
1300: 63 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69  ck..    */.    i
1310: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 73 71  f( SQLITE_OK==sq
1320: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74 72 79 28  lite3_mutex_try(
1330: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 7b  p->db->mutex) ){
1340: 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b 3d 20  .      nFree += 
1350: 73 71 6c 69 74 65 33 56 64 62 65 52 65 6c 65 61  sqlite3VdbeRelea
1360: 73 65 42 75 66 66 65 72 73 28 70 29 3b 0a 20 20  seBuffers(p);.  
1370: 20 20 20 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76      stmtLruRemov
1380: 65 4e 6f 6d 75 74 65 78 28 70 29 3b 0a 20 20 20  eNomutex(p);.   
1390: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
13a0: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75  _leave(p->db->mu
13b0: 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  tex);.    }.  }.
13c0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
13d0: 6c 65 61 76 65 28 73 71 6c 69 74 65 33 4d 75 74  leave(sqlite3Mut
13e0: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d  exAlloc(SQLITE_M
13f0: 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32  UTEX_STATIC_LRU2
1400: 29 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 6e 46  ));..  return nF
1410: 72 65 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61  ree;.}../*.** Ca
1420: 6c 6c 20 73 71 6c 69 74 65 33 52 65 70 72 65 70  ll sqlite3Reprep
1430: 61 72 65 28 29 20 6f 6e 20 74 68 65 20 73 74 61  are() on the sta
1440: 74 65 6d 65 6e 74 2e 20 52 65 6d 6f 76 65 20 69  tement. Remove i
1450: 74 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 6c 72  t from the.** lr
1460: 75 20 6c 69 73 74 20 62 65 66 6f 72 65 20 64 6f  u list before do
1470: 69 6e 67 20 73 6f 2c 20 61 73 20 52 65 70 72 65  ing so, as Repre
1480: 70 61 72 65 28 29 20 77 69 6c 6c 20 66 72 65 65  pare() will free
1490: 20 61 6c 6c 20 74 68 65 0a 2a 2a 20 6d 65 6d 6f   all the.** memo
14a0: 72 79 20 72 65 67 69 73 74 65 72 20 62 75 66 66  ry register buff
14b0: 65 72 73 20 61 6e 79 77 61 79 2e 0a 2a 2f 0a 69  ers anyway..*/.i
14c0: 6e 74 20 76 64 62 65 52 65 70 72 65 70 61 72 65  nt vdbeReprepare
14d0: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 74 6d  (Vdbe *p){.  stm
14e0: 74 4c 72 75 52 65 6d 6f 76 65 28 70 29 3b 0a 20  tLruRemove(p);. 
14f0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 52   return sqlite3R
1500: 65 70 72 65 70 61 72 65 28 70 29 3b 0a 7d 0a 0a  eprepare(p);.}..
1510: 23 65 6c 73 65 20 20 20 20 20 20 20 2f 2a 20 21  #else       /* !
1520: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
1530: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20  MORY_MANAGEMENT 
1540: 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 73 74 6d  */.  #define stm
1550: 74 4c 72 75 52 65 6d 6f 76 65 28 78 29 0a 20 20  tLruRemove(x).  
1560: 23 64 65 66 69 6e 65 20 73 74 6d 74 4c 72 75 41  #define stmtLruA
1570: 64 64 28 78 29 0a 20 20 23 64 65 66 69 6e 65 20  dd(x).  #define 
1580: 76 64 62 65 52 65 70 72 65 70 61 72 65 28 78 29  vdbeReprepare(x)
1590: 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72   sqlite3Reprepar
15a0: 65 28 78 29 0a 23 65 6e 64 69 66 0a 0a 0a 23 69  e(x).#endif...#i
15b0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
15c0: 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a  T_DEPRECATED./*.
15d0: 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 28  ** Return TRUE (
15e0: 6e 6f 6e 2d 7a 65 72 6f 29 20 6f 66 20 74 68 65  non-zero) of the
15f0: 20 73 74 61 74 65 6d 65 6e 74 20 73 75 70 70 6c   statement suppl
1600: 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 6d 65  ied as an argume
1610: 6e 74 20 6e 65 65 64 73 0a 2a 2a 20 74 6f 20 62  nt needs.** to b
1620: 65 20 72 65 63 6f 6d 70 69 6c 65 64 2e 20 20 41  e recompiled.  A
1630: 20 73 74 61 74 65 6d 65 6e 74 20 6e 65 65 64 73   statement needs
1640: 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c 65   to be recompile
1650: 64 20 77 68 65 6e 65 76 65 72 20 74 68 65 0a 2a  d whenever the.*
1660: 2a 20 65 78 65 63 75 74 69 6f 6e 20 65 6e 76 69  * execution envi
1670: 72 6f 6e 6d 65 6e 74 20 63 68 61 6e 67 65 73 20  ronment changes 
1680: 69 6e 20 61 20 77 61 79 20 74 68 61 74 20 77 6f  in a way that wo
1690: 75 6c 64 20 61 6c 74 65 72 20 74 68 65 20 70 72  uld alter the pr
16a0: 6f 67 72 61 6d 0a 2a 2a 20 74 68 61 74 20 73 71  ogram.** that sq
16b0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20  lite3_prepare() 
16c0: 67 65 6e 65 72 61 74 65 73 2e 20 20 46 6f 72 20  generates.  For 
16d0: 65 78 61 6d 70 6c 65 2c 20 69 66 20 6e 65 77 20  example, if new 
16e0: 66 75 6e 63 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20  functions or.** 
16f0: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
1700: 63 65 73 20 61 72 65 20 72 65 67 69 73 74 65 72  ces are register
1710: 65 64 20 6f 72 20 69 66 20 61 6e 20 61 75 74 68  ed or if an auth
1720: 6f 72 69 7a 65 72 20 66 75 6e 63 74 69 6f 6e 20  orizer function 
1730: 69 73 0a 2a 2a 20 61 64 64 65 64 20 6f 72 20 63  is.** added or c
1740: 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  hanged..*/.int s
1750: 71 6c 69 74 65 33 5f 65 78 70 69 72 65 64 28 73  qlite3_expired(s
1760: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
1770: 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d  mt){.  Vdbe *p =
1780: 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20   (Vdbe*)pStmt;. 
1790: 20 72 65 74 75 72 6e 20 70 3d 3d 30 20 7c 7c 20   return p==0 || 
17a0: 70 2d 3e 65 78 70 69 72 65 64 3b 0a 7d 0a 23 65  p->expired;.}.#e
17b0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  ndif../*.** The 
17c0: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e  following routin
17d0: 65 20 64 65 73 74 72 6f 79 73 20 61 20 76 69 72  e destroys a vir
17e0: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 68 61  tual machine tha
17f0: 74 20 69 73 20 63 72 65 61 74 65 64 20 62 79 0a  t is created by.
1800: 2a 2a 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63  ** the sqlite3_c
1810: 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74 69 6e 65  ompile() routine
1820: 2e 20 54 68 65 20 69 6e 74 65 67 65 72 20 72 65  . The integer re
1830: 74 75 72 6e 65 64 20 69 73 20 61 6e 20 53 51 4c  turned is an SQL
1840: 49 54 45 5f 0a 2a 2a 20 73 75 63 63 65 73 73 2f  ITE_.** success/
1850: 66 61 69 6c 75 72 65 20 63 6f 64 65 20 74 68 61  failure code tha
1860: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
1870: 72 65 73 75 6c 74 20 6f 66 20 65 78 65 63 75 74  result of execut
1880: 69 6e 67 20 74 68 65 20 76 69 72 74 75 61 6c 0a  ing the virtual.
1890: 2a 2a 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a  ** machine..**.*
18a0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
18b0: 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 63 6f  ets the error co
18c0: 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20 72 65  de and string re
18d0: 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c  turned by.** sql
18e0: 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 2c 20  ite3_errcode(), 
18f0: 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 29  sqlite3_errmsg()
1900: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65 72 72   and sqlite3_err
1910: 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20  msg16()..*/.int 
1920: 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65  sqlite3_finalize
1930: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
1940: 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b  Stmt){.  int rc;
1950: 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20  .  if( pStmt==0 
1960: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
1970: 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a  TE_OK;.  }else{.
1980: 20 20 20 20 56 64 62 65 20 2a 76 20 3d 20 28 56      Vdbe *v = (V
1990: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20  dbe*)pStmt;.    
19a0: 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 2d  sqlite3 *db = v-
19b0: 3e 64 62 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f  >db;.#if SQLITE_
19c0: 54 48 52 45 41 44 53 41 46 45 0a 20 20 20 20 73  THREADSAFE.    s
19d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75  qlite3_mutex *mu
19e0: 74 65 78 20 3d 20 76 2d 3e 64 62 2d 3e 6d 75 74  tex = v->db->mut
19f0: 65 78 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73  ex;.#endif.    s
1a00: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
1a10: 65 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 73  er(mutex);.    s
1a20: 74 6d 74 4c 72 75 52 65 6d 6f 76 65 28 76 29 3b  tmtLruRemove(v);
1a30: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
1a40: 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28 76 29  3VdbeFinalize(v)
1a50: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
1a60: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63  e3ApiExit(db, rc
1a70: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
1a80: 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78  utex_leave(mutex
1a90: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
1aa0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 72  rc;.}../*.** Ter
1ab0: 6d 69 6e 61 74 65 20 74 68 65 20 63 75 72 72 65  minate the curre
1ac0: 6e 74 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20  nt execution of 
1ad0: 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  an SQL statement
1ae0: 20 61 6e 64 20 72 65 73 65 74 20 69 74 0a 2a 2a   and reset it.**
1af0: 20 62 61 63 6b 20 74 6f 20 69 74 73 20 73 74 61   back to its sta
1b00: 72 74 69 6e 67 20 73 74 61 74 65 20 73 6f 20 74  rting state so t
1b10: 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 72 65  hat it can be re
1b20: 75 73 65 64 2e 20 41 20 73 75 63 63 65 73 73 20  used. A success 
1b30: 63 6f 64 65 20 66 72 6f 6d 0a 2a 2a 20 74 68 65  code from.** the
1b40: 20 70 72 69 6f 72 20 65 78 65 63 75 74 69 6f 6e   prior execution
1b50: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a   is returned..**
1b60: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1b70: 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72 20   sets the error 
1b80: 63 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20  code and string 
1b90: 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73  returned by.** s
1ba0: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29  qlite3_errcode()
1bb0: 2c 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67  , sqlite3_errmsg
1bc0: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65  () and sqlite3_e
1bd0: 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e  rrmsg16()..*/.in
1be0: 74 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28  t sqlite3_reset(
1bf0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
1c00: 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  tmt){.  int rc;.
1c10: 20 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29    if( pStmt==0 )
1c20: 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
1c30: 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  E_OK;.  }else{. 
1c40: 20 20 20 56 64 62 65 20 2a 76 20 3d 20 28 56 64     Vdbe *v = (Vd
1c50: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20 73  be*)pStmt;.    s
1c60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
1c70: 65 72 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  er(v->db->mutex)
1c80: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
1c90: 65 33 56 64 62 65 52 65 73 65 74 28 76 29 3b 0a  e3VdbeReset(v);.
1ca0: 20 20 20 20 73 74 6d 74 4c 72 75 41 64 64 28 76      stmtLruAdd(v
1cb0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  );.    sqlite3Vd
1cc0: 62 65 4d 61 6b 65 52 65 61 64 79 28 76 2c 20 2d  beMakeReady(v, -
1cd0: 31 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 20  1, 0, 0, 0);.   
1ce0: 20 61 73 73 65 72 74 28 20 28 72 63 20 26 20 28   assert( (rc & (
1cf0: 76 2d 3e 64 62 2d 3e 65 72 72 4d 61 73 6b 29 29  v->db->errMask))
1d00: 3d 3d 72 63 20 29 3b 0a 20 20 20 20 72 63 20 3d  ==rc );.    rc =
1d10: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
1d20: 76 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 20 20  v->db, rc);.    
1d30: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
1d40: 61 76 65 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78  ave(v->db->mutex
1d50: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
1d60: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  rc;.}../*.** Set
1d70: 20 61 6c 6c 20 74 68 65 20 70 61 72 61 6d 65 74   all the paramet
1d80: 65 72 73 20 69 6e 20 74 68 65 20 63 6f 6d 70 69  ers in the compi
1d90: 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  led SQL statemen
1da0: 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2f 0a 69 6e  t to NULL..*/.in
1db0: 74 20 73 71 6c 69 74 65 33 5f 63 6c 65 61 72 5f  t sqlite3_clear_
1dc0: 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33  bindings(sqlite3
1dd0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
1de0: 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72 63   int i;.  int rc
1df0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
1e00: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a  Vdbe *p = (Vdbe*
1e10: 29 70 53 74 6d 74 3b 0a 23 69 66 20 53 51 4c 49  )pStmt;.#if SQLI
1e20: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20  TE_THREADSAFE.  
1e30: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d  sqlite3_mutex *m
1e40: 75 74 65 78 20 3d 20 28 28 56 64 62 65 2a 29 70  utex = ((Vdbe*)p
1e50: 53 74 6d 74 29 2d 3e 64 62 2d 3e 6d 75 74 65 78  Stmt)->db->mutex
1e60: 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74  ;.#endif.  sqlit
1e70: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d  e3_mutex_enter(m
1e80: 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 69 3d 30  utex);.  for(i=0
1e90: 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69 2b 2b  ; i<p->nVar; i++
1ea0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
1eb0: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 70 2d  beMemRelease(&p-
1ec0: 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 20 20 20 70  >aVar[i]);.    p
1ed0: 2d 3e 61 56 61 72 5b 69 5d 2e 66 6c 61 67 73 20  ->aVar[i].flags 
1ee0: 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a  = MEM_Null;.  }.
1ef0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
1f00: 6c 65 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20  leave(mutex);.  
1f10: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f  return rc;.}.../
1f20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1f30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c  ************ sql
1f40: 69 74 65 33 5f 76 61 6c 75 65 5f 20 20 2a 2a 2a  ite3_value_  ***
1f50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1f60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20  ************.** 
1f70: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f  The following ro
1f80: 75 74 69 6e 65 73 20 65 78 74 72 61 63 74 20 69  utines extract i
1f90: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20  nformation from 
1fa0: 61 20 4d 65 6d 20 6f 72 20 73 71 6c 69 74 65 33  a Mem or sqlite3
1fb0: 5f 76 61 6c 75 65 0a 2a 2a 20 73 74 72 75 63 74  _value.** struct
1fc0: 75 72 65 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f  ure..*/.const vo
1fd0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75  id *sqlite3_valu
1fe0: 65 5f 62 6c 6f 62 28 73 71 6c 69 74 65 33 5f 76  e_blob(sqlite3_v
1ff0: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 4d  alue *pVal){.  M
2000: 65 6d 20 2a 70 20 3d 20 28 4d 65 6d 2a 29 70 56  em *p = (Mem*)pV
2010: 61 6c 3b 0a 20 20 69 66 28 20 70 2d 3e 66 6c 61  al;.  if( p->fla
2020: 67 73 20 26 20 28 4d 45 4d 5f 42 6c 6f 62 7c 4d  gs & (MEM_Blob|M
2030: 45 4d 5f 53 74 72 29 20 29 7b 0a 20 20 20 20 73  EM_Str) ){.    s
2040: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45 78 70  qlite3VdbeMemExp
2050: 61 6e 64 42 6c 6f 62 28 70 29 3b 0a 20 20 20 20  andBlob(p);.    
2060: 70 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 4d 45 4d  p->flags &= ~MEM
2070: 5f 53 74 72 3b 0a 20 20 20 20 70 2d 3e 66 6c 61  _Str;.    p->fla
2080: 67 73 20 7c 3d 20 4d 45 4d 5f 42 6c 6f 62 3b 0a  gs |= MEM_Blob;.
2090: 20 20 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a 3b      return p->z;
20a0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65  .  }else{.    re
20b0: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c  turn sqlite3_val
20c0: 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a 20  ue_text(pVal);. 
20d0: 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33   }.}.int sqlite3
20e0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71 6c  _value_bytes(sql
20f0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
2100: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
2110: 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70 56  te3ValueBytes(pV
2120: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29  al, SQLITE_UTF8)
2130: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
2140: 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73 71  value_bytes16(sq
2150: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
2160: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
2170: 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70  ite3ValueBytes(p
2180: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Val, SQLITE_UTF1
2190: 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75 62  6NATIVE);.}.doub
21a0: 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  le sqlite3_value
21b0: 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f  _double(sqlite3_
21c0: 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20  value *pVal){.  
21d0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64  return sqlite3Vd
21e0: 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65 6d  beRealValue((Mem
21f0: 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20 73  *)pVal);.}.int s
2200: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
2210: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
2220: 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20  pVal){.  return 
2230: 28 69 6e 74 29 73 71 6c 69 74 65 33 56 64 62 65  (int)sqlite3Vdbe
2240: 49 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70  IntValue((Mem*)p
2250: 56 61 6c 29 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69  Val);.}.sqlite_i
2260: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 76 61 6c  nt64 sqlite3_val
2270: 75 65 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33  ue_int64(sqlite3
2280: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
2290: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
22a0: 64 62 65 49 6e 74 56 61 6c 75 65 28 28 4d 65 6d  dbeIntValue((Mem
22b0: 2a 29 70 56 61 6c 29 3b 0a 7d 0a 63 6f 6e 73 74  *)pVal);.}.const
22c0: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
22d0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
22e0: 78 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  xt(sqlite3_value
22f0: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72   *pVal){.  retur
2300: 6e 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65  n (const unsigne
2310: 64 20 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33  d char *)sqlite3
2320: 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20  ValueText(pVal, 
2330: 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a  SQLITE_UTF8);.}.
2340: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
2350: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
2360: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61  void *sqlite3_va
2370: 6c 75 65 5f 74 65 78 74 31 36 28 73 71 6c 69 74  lue_text16(sqlit
2380: 65 33 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b  e3_value* pVal){
2390: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
23a0: 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c  3ValueText(pVal,
23b0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54   SQLITE_UTF16NAT
23c0: 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f  IVE);.}.const vo
23d0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75  id *sqlite3_valu
23e0: 65 5f 74 65 78 74 31 36 62 65 28 73 71 6c 69 74  e_text16be(sqlit
23f0: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b  e3_value *pVal){
2400: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
2410: 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c  3ValueText(pVal,
2420: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 29   SQLITE_UTF16BE)
2430: 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a  ;.}.const void *
2440: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
2450: 78 74 31 36 6c 65 28 73 71 6c 69 74 65 33 5f 76  xt16le(sqlite3_v
2460: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72  alue *pVal){.  r
2470: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c  eturn sqlite3Val
2480: 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c  ueText(pVal, SQL
2490: 49 54 45 5f 55 54 46 31 36 4c 45 29 3b 0a 7d 0a  ITE_UTF16LE);.}.
24a0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
24b0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69  _OMIT_UTF16 */.i
24c0: 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  nt sqlite3_value
24d0: 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 76 61  _type(sqlite3_va
24e0: 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 20 72 65  lue* pVal){.  re
24f0: 74 75 72 6e 20 70 56 61 6c 2d 3e 74 79 70 65 3b  turn pVal->type;
2500: 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .}../***********
2510: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2520: 2a 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  * sqlite3_result
2530: 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  _  *************
2540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2550: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  **.** The follow
2560: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61 72 65  ing routines are
2570: 20 75 73 65 64 20 62 79 20 75 73 65 72 2d 64 65   used by user-de
2580: 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20  fined functions 
2590: 74 6f 20 73 70 65 63 69 66 79 0a 2a 2a 20 74 68  to specify.** th
25a0: 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 73 75 6c  e function resul
25b0: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
25c0: 65 33 5f 72 65 73 75 6c 74 5f 62 6c 6f 62 28 0a  e3_result_blob(.
25d0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
25e0: 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73  t *pCtx, .  cons
25f0: 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e  t void *z, .  in
2600: 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  t n, .  void (*x
2610: 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a  Del)(void *).){.
2620: 20 20 61 73 73 65 72 74 28 20 6e 3e 3d 30 20 29    assert( n>=0 )
2630: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
2640: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
2650: 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78  Ctx->s.db->mutex
2660: 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  ) );.  sqlite3Vd
2670: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74  beMemSetStr(&pCt
2680: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78  x->s, z, n, 0, x
2690: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Del);.}.void sql
26a0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62  ite3_result_doub
26b0: 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  le(sqlite3_conte
26c0: 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65  xt *pCtx, double
26d0: 20 72 56 61 6c 29 7b 0a 20 20 61 73 73 65 72 74   rVal){.  assert
26e0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
26f0: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d  held(pCtx->s.db-
2700: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c  >mutex) );.  sql
2710: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 44 6f  ite3VdbeMemSetDo
2720: 75 62 6c 65 28 26 70 43 74 78 2d 3e 73 2c 20 72  uble(&pCtx->s, r
2730: 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Val);.}.void sql
2740: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
2750: 72 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  r(sqlite3_contex
2760: 74 20 2a 70 43 74 78 2c 20 63 6f 6e 73 74 20 63  t *pCtx, const c
2770: 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a  har *z, int n){.
2780: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
2790: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
27a0: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
27b0: 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73 45 72 72  );.  pCtx->isErr
27c0: 6f 72 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f  or = SQLITE_ERRO
27d0: 52 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  R;.  sqlite3Vdbe
27e0: 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d  MemSetStr(&pCtx-
27f0: 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45  >s, z, n, SQLITE
2800: 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 54 52  _UTF8, SQLITE_TR
2810: 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a 23 69 66 6e  ANSIENT);.}.#ifn
2820: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
2830: 55 54 46 31 36 0a 76 6f 69 64 20 73 71 6c 69 74  UTF16.void sqlit
2840: 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 31  e3_result_error1
2850: 36 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  6(sqlite3_contex
2860: 74 20 2a 70 43 74 78 2c 20 63 6f 6e 73 74 20 76  t *pCtx, const v
2870: 6f 69 64 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a  oid *z, int n){.
2880: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
2890: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
28a0: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
28b0: 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73 45 72 72  );.  pCtx->isErr
28c0: 6f 72 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f  or = SQLITE_ERRO
28d0: 52 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  R;.  sqlite3Vdbe
28e0: 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d  MemSetStr(&pCtx-
28f0: 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45  >s, z, n, SQLITE
2900: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51  _UTF16NATIVE, SQ
2910: 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b  LITE_TRANSIENT);
2920: 0a 7d 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73  .}.#endif.void s
2930: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e  qlite3_result_in
2940: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  t(sqlite3_contex
2950: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 56 61  t *pCtx, int iVa
2960: 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  l){.  assert( sq
2970: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
2980: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74  (pCtx->s.db->mut
2990: 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  ex) );.  sqlite3
29a0: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28  VdbeMemSetInt64(
29b0: 26 70 43 74 78 2d 3e 73 2c 20 28 69 36 34 29 69  &pCtx->s, (i64)i
29c0: 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Val);.}.void sql
29d0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36  ite3_result_int6
29e0: 34 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  4(sqlite3_contex
29f0: 74 20 2a 70 43 74 78 2c 20 69 36 34 20 69 56 61  t *pCtx, i64 iVa
2a00: 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  l){.  assert( sq
2a10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
2a20: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74  (pCtx->s.db->mut
2a30: 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  ex) );.  sqlite3
2a40: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28  VdbeMemSetInt64(
2a50: 26 70 43 74 78 2d 3e 73 2c 20 69 56 61 6c 29 3b  &pCtx->s, iVal);
2a60: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
2a70: 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 73 71 6c 69  result_null(sqli
2a80: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
2a90: 78 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  x){.  assert( sq
2aa0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
2ab0: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74  (pCtx->s.db->mut
2ac0: 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33  ex) );.  sqlite3
2ad0: 56 64 62 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 26  VdbeMemSetNull(&
2ae0: 70 43 74 78 2d 3e 73 29 3b 0a 7d 0a 76 6f 69 64  pCtx->s);.}.void
2af0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
2b00: 74 65 78 74 28 0a 20 20 73 71 6c 69 74 65 33 5f  text(.  sqlite3_
2b10: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a  context *pCtx, .
2b20: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c    const char *z,
2b30: 20 0a 20 20 69 6e 74 20 6e 2c 0a 20 20 76 6f 69   .  int n,.  voi
2b40: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a  d (*xDel)(void *
2b50: 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73  ).){.  assert( s
2b60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2b70: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2b80: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  tex) );.  sqlite
2b90: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
2ba0: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
2bb0: 51 4c 49 54 45 5f 55 54 46 38 2c 20 78 44 65 6c  QLITE_UTF8, xDel
2bc0: 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  );.}.#ifndef SQL
2bd0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 76  ITE_OMIT_UTF16.v
2be0: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
2bf0: 6c 74 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c  lt_text16(.  sql
2c00: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
2c10: 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69  tx, .  const voi
2c20: 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20  d *z, .  int n, 
2c30: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
2c40: 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73  void *).){.  ass
2c50: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
2c60: 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e  ex_held(pCtx->s.
2c70: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  db->mutex) );.  
2c80: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
2c90: 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a  tStr(&pCtx->s, z
2ca0: 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  , n, SQLITE_UTF1
2cb0: 36 4e 41 54 49 56 45 2c 20 78 44 65 6c 29 3b 0a  6NATIVE, xDel);.
2cc0: 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72  }.void sqlite3_r
2cd0: 65 73 75 6c 74 5f 74 65 78 74 31 36 62 65 28 0a  esult_text16be(.
2ce0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
2cf0: 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73  t *pCtx, .  cons
2d00: 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e  t void *z, .  in
2d10: 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  t n, .  void (*x
2d20: 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a  Del)(void *).){.
2d30: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
2d40: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
2d50: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
2d60: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
2d70: 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d  MemSetStr(&pCtx-
2d80: 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45  >s, z, n, SQLITE
2d90: 5f 55 54 46 31 36 42 45 2c 20 78 44 65 6c 29 3b  _UTF16BE, xDel);
2da0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  .}.void sqlite3_
2db0: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 28  result_text16le(
2dc0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
2dd0: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e  xt *pCtx, .  con
2de0: 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69  st void *z, .  i
2df0: 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a  nt n, .  void (*
2e00: 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b  xDel)(void *).){
2e10: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
2e20: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
2e30: 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29  tx->s.db->mutex)
2e40: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   );.  sqlite3Vdb
2e50: 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78  eMemSetStr(&pCtx
2e60: 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54  ->s, z, n, SQLIT
2e70: 45 5f 55 54 46 31 36 4c 45 2c 20 78 44 65 6c 29  E_UTF16LE, xDel)
2e80: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
2e90: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20  LITE_OMIT_UTF16 
2ea0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  */.void sqlite3_
2eb0: 72 65 73 75 6c 74 5f 76 61 6c 75 65 28 73 71 6c  result_value(sql
2ec0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
2ed0: 74 78 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  tx, sqlite3_valu
2ee0: 65 20 2a 70 56 61 6c 75 65 29 7b 0a 20 20 61 73  e *pValue){.  as
2ef0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
2f00: 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73  tex_held(pCtx->s
2f10: 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  .db->mutex) );. 
2f20: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43   sqlite3VdbeMemC
2f30: 6f 70 79 28 26 70 43 74 78 2d 3e 73 2c 20 70 56  opy(&pCtx->s, pV
2f40: 61 6c 75 65 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  alue);.}.void sq
2f50: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 7a 65 72  lite3_result_zer
2f60: 6f 62 6c 6f 62 28 73 71 6c 69 74 65 33 5f 63 6f  oblob(sqlite3_co
2f70: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74  ntext *pCtx, int
2f80: 20 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73   n){.  assert( s
2f90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2fa0: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2fb0: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  tex) );.  sqlite
2fc0: 33 56 64 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42  3VdbeMemSetZeroB
2fd0: 6c 6f 62 28 26 70 43 74 78 2d 3e 73 2c 20 6e 29  lob(&pCtx->s, n)
2fe0: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  ;.}.void sqlite3
2ff0: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 63 6f  _result_error_co
3000: 64 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  de(sqlite3_conte
3010: 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 65 72  xt *pCtx, int er
3020: 72 43 6f 64 65 29 7b 0a 20 20 70 43 74 78 2d 3e  rCode){.  pCtx->
3030: 69 73 45 72 72 6f 72 20 3d 20 65 72 72 43 6f 64  isError = errCod
3040: 65 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 63 65 20 61  e;.}../* Force a
3050: 6e 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 20  n SQLITE_TOOBIG 
3060: 65 72 72 6f 72 2e 20 2a 2f 0a 76 6f 69 64 20 73  error. */.void s
3070: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72  qlite3_result_er
3080: 72 6f 72 5f 74 6f 6f 62 69 67 28 73 71 6c 69 74  ror_toobig(sqlit
3090: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
30a0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ){.  assert( sql
30b0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
30c0: 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65  pCtx->s.db->mute
30d0: 78 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73  x) );.  pCtx->is
30e0: 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45 5f 54  Error = SQLITE_T
30f0: 4f 4f 42 49 47 3b 0a 20 20 73 71 6c 69 74 65 33  OOBIG;.  sqlite3
3100: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70  VdbeMemSetStr(&p
3110: 43 74 78 2d 3e 73 2c 20 22 73 74 72 69 6e 67 20  Ctx->s, "string 
3120: 6f 72 20 62 6c 6f 62 20 74 6f 6f 20 62 69 67 22  or blob too big"
3130: 2c 20 2d 31 2c 20 0a 20 20 20 20 20 20 20 20 20  , -1, .         
3140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51                SQ
3150: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54  LITE_UTF8, SQLIT
3160: 45 5f 53 54 41 54 49 43 29 3b 0a 7d 0a 0a 2f 2a  E_STATIC);.}../*
3170: 20 41 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d   An SQLITE_NOMEM
3180: 20 65 72 72 6f 72 2e 20 2a 2f 0a 76 6f 69 64 20   error. */.void 
3190: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
31a0: 72 72 6f 72 5f 6e 6f 6d 65 6d 28 73 71 6c 69 74  rror_nomem(sqlit
31b0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
31c0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ){.  assert( sql
31d0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
31e0: 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65  pCtx->s.db->mute
31f0: 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  x) );.  sqlite3V
3200: 64 62 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 26 70  dbeMemSetNull(&p
3210: 43 74 78 2d 3e 73 29 3b 0a 20 20 70 43 74 78 2d  Ctx->s);.  pCtx-
3220: 3e 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54  >isError = SQLIT
3230: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 70 43 74 78 2d  E_NOMEM;.  pCtx-
3240: 3e 73 2e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  >s.db->mallocFai
3250: 6c 65 64 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a  led = 1;.}../*.*
3260: 2a 20 45 78 65 63 75 74 65 20 74 68 65 20 73 74  * Execute the st
3270: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65  atement pStmt, e
3280: 69 74 68 65 72 20 75 6e 74 69 6c 20 61 20 72 6f  ither until a ro
3290: 77 20 6f 66 20 64 61 74 61 20 69 73 20 72 65 61  w of data is rea
32a0: 64 79 2c 20 74 68 65 0a 2a 2a 20 73 74 61 74 65  dy, the.** state
32b0: 6d 65 6e 74 20 69 73 20 63 6f 6d 70 6c 65 74 65  ment is complete
32c0: 6c 79 20 65 78 65 63 75 74 65 64 20 6f 72 20 61  ly executed or a
32d0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a  n error occurs..
32e0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  **.** This routi
32f0: 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68  ne implements th
3300: 65 20 62 75 6c 6b 20 6f 66 20 74 68 65 20 6c 6f  e bulk of the lo
3310: 67 69 63 20 62 65 68 69 6e 64 20 74 68 65 20 73  gic behind the s
3320: 71 6c 69 74 65 5f 73 74 65 70 28 29 0a 2a 2a 20  qlite_step().** 
3330: 41 50 49 2e 20 20 54 68 65 20 6f 6e 6c 79 20 74  API.  The only t
3340: 68 69 6e 67 20 6f 6d 69 74 74 65 64 20 69 73 20  hing omitted is 
3350: 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 72 65  the automatic re
3360: 63 6f 6d 70 69 6c 65 20 69 66 20 61 20 0a 2a 2a  compile if a .**
3370: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20 68   schema change h
3380: 61 73 20 6f 63 63 75 72 72 65 64 2e 20 20 54 68  as occurred.  Th
3390: 61 74 20 64 65 74 61 69 6c 20 69 73 20 68 61 6e  at detail is han
33a0: 64 6c 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 6f  dled by the.** o
33b0: 75 74 65 72 20 73 71 6c 69 74 65 33 5f 73 74 65  uter sqlite3_ste
33c0: 70 28 29 20 77 72 61 70 70 65 72 20 70 72 6f 63  p() wrapper proc
33d0: 65 64 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  edure..*/.static
33e0: 20 69 6e 74 20 73 71 6c 69 74 65 33 53 74 65 70   int sqlite3Step
33f0: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c  (Vdbe *p){.  sql
3400: 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20  ite3 *db;.  int 
3410: 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 70 29  rc;..  assert(p)
3420: 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63  ;.  if( p->magic
3430: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  !=VDBE_MAGIC_RUN
3440: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
3450: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
3460: 7d 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 74  }..  /* Assert t
3470: 68 61 74 20 6d 61 6c 6c 6f 63 28 29 20 68 61 73  hat malloc() has
3480: 20 6e 6f 74 20 66 61 69 6c 65 64 20 2a 2f 0a 20   not failed */. 
3490: 20 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69   db = p->db;.  i
34a0: 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  f( db->mallocFai
34b0: 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72  led ){.    retur
34c0: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
34d0: 20 20 7d 0a 0a 20 20 69 66 28 20 70 2d 3e 70 63    }..  if( p->pc
34e0: 3c 3d 30 20 26 26 20 70 2d 3e 65 78 70 69 72 65  <=0 && p->expire
34f0: 64 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e  d ){.    if( p->
3500: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
3510: 0a 20 20 20 20 20 20 70 2d 3e 72 63 20 3d 20 53  .      p->rc = S
3520: 51 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a 20 20  QLITE_SCHEMA;.  
3530: 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 53 51 4c    }.    rc = SQL
3540: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 67  ITE_ERROR;.    g
3550: 6f 74 6f 20 65 6e 64 5f 6f 66 5f 73 74 65 70 3b  oto end_of_step;
3560: 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74  .  }.  if( sqlit
3570: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
3580: 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51  {.    p->rc = SQ
3590: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 20  LITE_MISUSE;.   
35a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
35b0: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28  ISUSE;.  }.  if(
35c0: 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20 20 20 20   p->pc<0 ){.    
35d0: 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20  /* If there are 
35e0: 6e 6f 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65  no other stateme
35f0: 6e 74 73 20 63 75 72 72 65 6e 74 6c 79 20 72 75  nts currently ru
3600: 6e 6e 69 6e 67 2c 20 74 68 65 6e 0a 20 20 20 20  nning, then.    
3610: 2a 2a 20 72 65 73 65 74 20 74 68 65 20 69 6e 74  ** reset the int
3620: 65 72 72 75 70 74 20 66 6c 61 67 2e 20 20 54 68  errupt flag.  Th
3630: 69 73 20 70 72 65 76 65 6e 74 73 20 61 20 63 61  is prevents a ca
3640: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 69 6e  ll to sqlite3_in
3650: 74 65 72 72 75 70 74 0a 20 20 20 20 2a 2a 20 66  terrupt.    ** f
3660: 72 6f 6d 20 69 6e 74 65 72 72 75 70 74 69 6e 67  rom interrupting
3670: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61   a statement tha
3680: 74 20 68 61 73 20 6e 6f 74 20 79 65 74 20 73 74  t has not yet st
3690: 61 72 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  arted..    */.  
36a0: 20 20 69 66 28 20 64 62 2d 3e 61 63 74 69 76 65    if( db->active
36b0: 56 64 62 65 43 6e 74 3d 3d 30 20 29 7b 0a 20 20  VdbeCnt==0 ){.  
36c0: 20 20 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74      db->u1.isInt
36d0: 65 72 72 75 70 74 65 64 20 3d 20 30 3b 0a 20 20  errupted = 0;.  
36e0: 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c    }..#ifndef SQL
36f0: 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 20  ITE_OMIT_TRACE. 
3700: 20 20 20 69 66 28 20 64 62 2d 3e 78 50 72 6f 66     if( db->xProf
3710: 69 6c 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74  ile && !db->init
3720: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 64  .busy ){.      d
3730: 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20 20  ouble rNow;.    
3740: 20 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65    sqlite3OsCurre
3750: 6e 74 54 69 6d 65 28 64 62 2d 3e 70 56 66 73 2c  ntTime(db->pVfs,
3760: 20 26 72 4e 6f 77 29 3b 0a 20 20 20 20 20 20 70   &rNow);.      p
3770: 2d 3e 73 74 61 72 74 54 69 6d 65 20 3d 20 28 75  ->startTime = (u
3780: 36 34 29 28 28 72 4e 6f 77 20 2d 20 28 69 6e 74  64)((rNow - (int
3790: 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32 34  )rNow)*3600.0*24
37a0: 2e 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30 29  .0*1000000000.0)
37b0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a  ;.    }.#endif..
37c0: 20 20 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64      db->activeVd
37d0: 62 65 43 6e 74 2b 2b 3b 0a 20 20 20 20 69 66 28  beCnt++;.    if(
37e0: 20 70 2d 3e 72 65 61 64 4f 6e 6c 79 3d 3d 30 20   p->readOnly==0 
37f0: 29 20 64 62 2d 3e 77 72 69 74 65 56 64 62 65 43  ) db->writeVdbeC
3800: 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e 70 63 20  nt++;.    p->pc 
3810: 3d 20 30 3b 0a 20 20 20 20 73 74 6d 74 4c 72 75  = 0;.    stmtLru
3820: 52 65 6d 6f 76 65 28 70 29 3b 0a 20 20 7d 0a 23  Remove(p);.  }.#
3830: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
3840: 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69 66 28  IT_EXPLAIN.  if(
3850: 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 7b 0a 20   p->explain ){. 
3860: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
3870: 64 62 65 4c 69 73 74 28 70 29 3b 0a 20 20 7d 65  dbeList(p);.  }e
3880: 6c 73 65 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  lse.#endif /* SQ
3890: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49  LITE_OMIT_EXPLAI
38a0: 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 20 72 63 20  N */.  {.    rc 
38b0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 45 78 65  = sqlite3VdbeExe
38c0: 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  c(p);.  }..  if(
38d0: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66   sqlite3SafetyOf
38e0: 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63 20  f(db) ){.    rc 
38f0: 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  = SQLITE_MISUSE;
3900: 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51  .  }..#ifndef SQ
3910: 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a  LITE_OMIT_TRACE.
3920: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20    /* Invoke the 
3930: 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b  profile callback
3940: 20 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65   if there is one
3950: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d  .  */.  if( rc!=
3960: 53 51 4c 49 54 45 5f 52 4f 57 20 26 26 20 64 62  SQLITE_ROW && db
3970: 2d 3e 78 50 72 6f 66 69 6c 65 20 26 26 20 21 64  ->xProfile && !d
3980: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 26 26 20  b->init.busy && 
3990: 70 2d 3e 7a 53 71 6c 20 29 7b 0a 20 20 20 20 64  p->zSql ){.    d
39a0: 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20 20  ouble rNow;.    
39b0: 75 36 34 20 65 6c 61 70 73 65 54 69 6d 65 3b 0a  u64 elapseTime;.
39c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 75  .    sqlite3OsCu
39d0: 72 72 65 6e 74 54 69 6d 65 28 64 62 2d 3e 70 56  rrentTime(db->pV
39e0: 66 73 2c 20 26 72 4e 6f 77 29 3b 0a 20 20 20 20  fs, &rNow);.    
39f0: 65 6c 61 70 73 65 54 69 6d 65 20 3d 20 28 75 36  elapseTime = (u6
3a00: 34 29 28 28 72 4e 6f 77 20 2d 20 28 69 6e 74 29  4)((rNow - (int)
3a10: 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32 34 2e  rNow)*3600.0*24.
3a20: 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30 29 3b  0*1000000000.0);
3a30: 0a 20 20 20 20 65 6c 61 70 73 65 54 69 6d 65 20  .    elapseTime 
3a40: 2d 3d 20 70 2d 3e 73 74 61 72 74 54 69 6d 65 3b  -= p->startTime;
3a50: 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 66 69 6c  .    db->xProfil
3a60: 65 28 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72  e(db->pProfileAr
3a70: 67 2c 20 70 2d 3e 7a 53 71 6c 2c 20 65 6c 61 70  g, p->zSql, elap
3a80: 73 65 54 69 6d 65 29 3b 0a 20 20 7d 0a 23 65 6e  seTime);.  }.#en
3a90: 64 69 66 0a 0a 20 20 64 62 2d 3e 65 72 72 43 6f  dif..  db->errCo
3aa0: 64 65 20 3d 20 72 63 3b 0a 20 20 69 66 28 20 53  de = rc;.  if( S
3ab0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3d 3d 73 71 6c  QLITE_NOMEM==sql
3ac0: 69 74 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64  ite3ApiExit(p->d
3ad0: 62 2c 20 70 2d 3e 72 63 29 20 29 7b 0a 20 20 20  b, p->rc) ){.   
3ae0: 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   p->rc = SQLITE_
3af0: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 65 6e 64 5f 6f  NOMEM;.  }.end_o
3b00: 66 5f 73 74 65 70 3a 0a 20 20 2f 2a 20 41 74 20  f_step:.  /* At 
3b10: 74 68 69 73 20 70 6f 69 6e 74 20 6c 6f 63 61 6c  this point local
3b20: 20 76 61 72 69 61 62 6c 65 20 72 63 20 68 6f 6c   variable rc hol
3b30: 64 73 20 74 68 65 20 76 61 6c 75 65 20 74 68 61  ds the value tha
3b40: 74 20 73 68 6f 75 6c 64 20 62 65 20 0a 20 20 2a  t should be .  *
3b50: 2a 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68  * returned if th
3b60: 69 73 20 73 74 61 74 65 6d 65 6e 74 20 77 61 73  is statement was
3b70: 20 63 6f 6d 70 69 6c 65 64 20 75 73 69 6e 67 20   compiled using 
3b80: 74 68 65 20 6c 65 67 61 63 79 20 0a 20 20 2a 2a  the legacy .  **
3b90: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
3ba0: 28 29 20 69 6e 74 65 72 66 61 63 65 2e 20 41 63  () interface. Ac
3bb0: 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 64  cording to the d
3bc0: 6f 63 73 2c 20 74 68 69 73 20 63 61 6e 20 6f 6e  ocs, this can on
3bd0: 6c 79 0a 20 20 2a 2a 20 62 65 20 6f 6e 65 20 6f  ly.  ** be one o
3be0: 66 20 74 68 65 20 76 61 6c 75 65 73 20 69 6e 20  f the values in 
3bf0: 74 68 65 20 66 69 72 73 74 20 61 73 73 65 72 74  the first assert
3c00: 28 29 20 62 65 6c 6f 77 2e 20 56 61 72 69 61 62  () below. Variab
3c10: 6c 65 20 70 2d 3e 72 63 20 0a 20 20 2a 2a 20 63  le p->rc .  ** c
3c20: 6f 6e 74 61 69 6e 73 20 74 68 65 20 76 61 6c 75  ontains the valu
3c30: 65 20 74 68 61 74 20 77 6f 75 6c 64 20 62 65 20  e that would be 
3c40: 72 65 74 75 72 6e 65 64 20 69 66 20 73 71 6c 69  returned if sqli
3c50: 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 29 20 0a  te3_finalize() .
3c60: 20 20 2a 2a 20 77 65 72 65 20 63 61 6c 6c 65 64    ** were called
3c70: 20 6f 6e 20 73 74 61 74 65 6d 65 6e 74 20 70 2e   on statement p.
3c80: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
3c90: 72 63 3d 3d 53 51 4c 49 54 45 5f 52 4f 57 20 20  rc==SQLITE_ROW  
3ca0: 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f  || rc==SQLITE_DO
3cb0: 4e 45 20 20 20 7c 7c 20 72 63 3d 3d 53 51 4c 49  NE   || rc==SQLI
3cc0: 54 45 5f 45 52 52 4f 52 20 0a 20 20 20 20 20 20  TE_ERROR .      
3cd0: 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42   || rc==SQLITE_B
3ce0: 55 53 59 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54  USY || rc==SQLIT
3cf0: 45 5f 4d 49 53 55 53 45 0a 20 20 29 3b 0a 20 20  E_MISUSE.  );.  
3d00: 61 73 73 65 72 74 28 20 70 2d 3e 72 63 21 3d 53  assert( p->rc!=S
3d10: 51 4c 49 54 45 5f 52 4f 57 20 26 26 20 70 2d 3e  QLITE_ROW && p->
3d20: 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20  rc!=SQLITE_DONE 
3d30: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 69 73 50 72  );.  if( p->isPr
3d40: 65 70 61 72 65 56 32 20 26 26 20 72 63 21 3d 53  epareV2 && rc!=S
3d50: 51 4c 49 54 45 5f 52 4f 57 20 26 26 20 72 63 21  QLITE_ROW && rc!
3d60: 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 7b 0a  =SQLITE_DONE ){.
3d70: 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 73      /* If this s
3d80: 74 61 74 65 6d 65 6e 74 20 77 61 73 20 70 72 65  tatement was pre
3d90: 70 61 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69  pared using sqli
3da0: 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29  te3_prepare_v2()
3db0: 2c 20 61 6e 64 20 61 6e 0a 20 20 20 20 2a 2a 20  , and an.    ** 
3dc0: 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 65  error has occure
3dd0: 64 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74  d, then return t
3de0: 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 6e  he error code in
3df0: 20 70 2d 3e 72 63 20 74 6f 20 74 68 65 0a 20 20   p->rc to the.  
3e00: 20 20 2a 2a 20 63 61 6c 6c 65 72 2e 20 53 65 74    ** caller. Set
3e10: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   the error code 
3e20: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
3e30: 68 61 6e 64 6c 65 20 74 6f 20 74 68 65 20 73 61  handle to the sa
3e40: 6d 65 20 76 61 6c 75 65 2e 0a 20 20 20 20 2a 2f  me value..    */
3e50: 20 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65   .    rc = db->e
3e60: 72 72 43 6f 64 65 20 3d 20 70 2d 3e 72 63 3b 0a  rrCode = p->rc;.
3e70: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 72 63    }.  return (rc
3e80: 26 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3b 0a 7d  &db->errMask);.}
3e90: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20  ../*.** This is 
3ea0: 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 69 6d  the top-level im
3eb0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
3ec0: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 20  sqlite3_step(). 
3ed0: 20 43 61 6c 6c 0a 2a 2a 20 73 71 6c 69 74 65 33   Call.** sqlite3
3ee0: 53 74 65 70 28 29 20 74 6f 20 64 6f 20 6d 6f 73  Step() to do mos
3ef0: 74 20 6f 66 20 74 68 65 20 77 6f 72 6b 2e 20 20  t of the work.  
3f00: 49 66 20 61 20 73 63 68 65 6d 61 20 65 72 72 6f  If a schema erro
3f10: 72 20 6f 63 63 75 72 73 2c 0a 2a 2a 20 63 61 6c  r occurs,.** cal
3f20: 6c 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61  l sqlite3Reprepa
3f30: 72 65 28 29 20 61 6e 64 20 74 72 79 20 61 67 61  re() and try aga
3f40: 69 6e 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51  in..*/.#ifdef SQ
3f50: 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 52 53 45 52  LITE_OMIT_PARSER
3f60: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 65  .int sqlite3_ste
3f70: 70 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  p(sqlite3_stmt *
3f80: 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63  pStmt){.  int rc
3f90: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
3fa0: 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 20 29 7b  ;.  if( pStmt ){
3fb0: 0a 20 20 20 20 56 64 62 65 20 2a 76 3b 0a 20 20  .    Vdbe *v;.  
3fc0: 20 20 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74    v = (Vdbe*)pSt
3fd0: 6d 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  mt;.    sqlite3_
3fe0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 76 2d 3e 64  mutex_enter(v->d
3ff0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72  b->mutex);.    r
4000: 63 20 3d 20 73 71 6c 69 74 65 33 53 74 65 70 28  c = sqlite3Step(
4010: 76 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  v);.    sqlite3_
4020: 6d 75 74 65 78 5f 6c 65 61 76 65 28 76 2d 3e 64  mutex_leave(v->d
4030: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20  b->mutex);.  }. 
4040: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65   return rc;.}.#e
4050: 6c 73 65 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  lse.int sqlite3_
4060: 73 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74 6d  step(sqlite3_stm
4070: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74  t *pStmt){.  int
4080: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53   rc = SQLITE_MIS
4090: 55 53 45 3b 0a 20 20 69 66 28 20 70 53 74 6d 74  USE;.  if( pStmt
40a0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 63 6e 74 20   ){.    int cnt 
40b0: 3d 20 30 3b 0a 20 20 20 20 56 64 62 65 20 2a 76  = 0;.    Vdbe *v
40c0: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b   = (Vdbe*)pStmt;
40d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62  .    sqlite3 *db
40e0: 20 3d 20 76 2d 3e 64 62 3b 0a 20 20 20 20 73 71   = v->db;.    sq
40f0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
4100: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
4110: 20 20 77 68 69 6c 65 28 20 28 72 63 20 3d 20 73    while( (rc = s
4120: 71 6c 69 74 65 33 53 74 65 70 28 76 29 29 3d 3d  qlite3Step(v))==
4130: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 0a 20 20  SQLITE_SCHEMA.  
4140: 20 20 20 20 20 20 20 20 20 26 26 20 63 6e 74 2b           && cnt+
4150: 2b 20 3c 20 35 0a 20 20 20 20 20 20 20 20 20 20  + < 5.          
4160: 20 26 26 20 28 72 63 20 3d 20 76 64 62 65 52 65   && (rc = vdbeRe
4170: 70 72 65 70 61 72 65 28 76 29 29 3d 3d 53 51 4c  prepare(v))==SQL
4180: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
4190: 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 70 53  sqlite3_reset(pS
41a0: 74 6d 74 29 3b 0a 20 20 20 20 20 20 76 2d 3e 65  tmt);.      v->e
41b0: 78 70 69 72 65 64 20 3d 20 30 3b 0a 20 20 20 20  xpired = 0;.    
41c0: 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51  }.    if( rc==SQ
41d0: 4c 49 54 45 5f 53 43 48 45 4d 41 20 26 26 20 76  LITE_SCHEMA && v
41e0: 2d 3e 69 73 50 72 65 70 61 72 65 56 32 20 26 26  ->isPrepareV2 &&
41f0: 20 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20   db->pErr ){.   
4200: 20 20 20 2f 2a 20 54 68 69 73 20 63 61 73 65 20     /* This case 
4210: 6f 63 63 75 72 73 20 61 66 74 65 72 20 66 61 69  occurs after fai
4220: 6c 69 6e 67 20 74 6f 20 72 65 63 6f 6d 70 69 6c  ling to recompil
4230: 65 20 61 6e 20 73 71 6c 20 73 74 61 74 65 6d 65  e an sql stateme
4240: 6e 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 54 68  nt. .      ** Th
4250: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  e error message 
4260: 66 72 6f 6d 20 74 68 65 20 53 51 4c 20 63 6f 6d  from the SQL com
4270: 70 69 6c 65 72 20 68 61 73 20 61 6c 72 65 61 64  piler has alread
4280: 79 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 0a 20  y been loaded . 
4290: 20 20 20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65       ** into the
42a0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
42b0: 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 63 6f 70  . This block cop
42c0: 69 65 73 20 74 68 65 20 65 72 72 6f 72 20 6d 65  ies the error me
42d0: 73 73 61 67 65 20 0a 20 20 20 20 20 20 2a 2a 20  ssage .      ** 
42e0: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73  from the databas
42f0: 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f 20 74 68  e handle into th
4300: 65 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20  e statement and 
4310: 73 65 74 73 20 74 68 65 20 73 74 61 74 65 6d 65  sets the stateme
4320: 6e 74 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 67  nt.      ** prog
4330: 72 61 6d 20 63 6f 75 6e 74 65 72 20 74 6f 20 30  ram counter to 0
4340: 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20   to ensure that 
4350: 77 68 65 6e 20 74 68 65 20 73 74 61 74 65 6d 65  when the stateme
4360: 6e 74 20 69 73 20 0a 20 20 20 20 20 20 2a 2a 20  nt is .      ** 
4370: 66 69 6e 61 6c 69 7a 65 64 20 6f 72 20 72 65 73  finalized or res
4380: 65 74 20 74 68 65 20 70 61 72 73 65 72 20 65 72  et the parser er
4390: 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20 61  ror message is a
43a0: 76 61 69 6c 61 62 6c 65 20 76 69 61 0a 20 20 20  vailable via.   
43b0: 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72     ** sqlite3_er
43c0: 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69 74  rmsg() and sqlit
43d0: 65 33 5f 65 72 72 63 6f 64 65 28 29 2e 0a 20 20  e3_errcode()..  
43e0: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 63 6f 6e      */.      con
43f0: 73 74 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20  st char *zErr = 
4400: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 73 71  (const char *)sq
4410: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
4420: 28 64 62 2d 3e 70 45 72 72 29 3b 20 0a 20 20 20  (db->pErr); .   
4430: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65     sqlite3DbFree
4440: 28 64 62 2c 20 76 2d 3e 7a 45 72 72 4d 73 67 29  (db, v->zErrMsg)
4450: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 64 62 2d  ;.      if( !db-
4460: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b  >mallocFailed ){
4470: 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72 72  .        v->zErr
4480: 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 44 62 53  Msg = sqlite3DbS
4490: 74 72 44 75 70 28 64 62 2c 20 7a 45 72 72 29 3b  trDup(db, zErr);
44a0: 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a  .      } else {.
44b0: 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72 72 4d          v->zErrM
44c0: 73 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  sg = 0;.        
44d0: 76 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e  v->rc = SQLITE_N
44e0: 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20  OMEM;.      }.  
44f0: 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c    }.    rc = sql
4500: 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20  ite3ApiExit(db, 
4510: 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  rc);.    sqlite3
4520: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d  _mutex_leave(db-
4530: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72  >mutex);.  }.  r
4540: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64  eturn rc;.}.#end
4550: 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63  if../*.** Extrac
4560: 74 20 74 68 65 20 75 73 65 72 20 64 61 74 61 20  t the user data 
4570: 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 5f 63  from a sqlite3_c
4580: 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 65  ontext structure
4590: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a 2a 2a   and return a.**
45a0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a   pointer to it..
45b0: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  */.void *sqlite3
45c0: 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c 69 74  _user_data(sqlit
45d0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a  e3_context *p){.
45e0: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70    assert( p && p
45f0: 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 65 74  ->pFunc );.  ret
4600: 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e 70 55  urn p->pFunc->pU
4610: 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a 2a  serData;.}../*.*
4620: 2a 20 45 78 74 72 61 63 74 20 74 68 65 20 75 73  * Extract the us
4630: 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 73  er data from a s
4640: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 73  qlite3_context s
4650: 74 72 75 63 74 75 72 65 20 61 6e 64 20 72 65 74  tructure and ret
4660: 75 72 6e 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72  urn a.** pointer
4670: 20 74 6f 20 69 74 2e 0a 2a 2f 0a 73 71 6c 69 74   to it..*/.sqlit
4680: 65 33 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6e 74  e3 *sqlite3_cont
4690: 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71  ext_db_handle(sq
46a0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
46b0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26  ){.  assert( p &
46c0: 26 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20  & p->pFunc );.  
46d0: 72 65 74 75 72 6e 20 70 2d 3e 73 2e 64 62 3b 0a  return p->s.db;.
46e0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  }../*.** The fol
46f0: 6c 6f 77 69 6e 67 20 69 73 20 74 68 65 20 69 6d  lowing is the im
4700: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
4710: 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20  an SQL function 
4720: 74 68 61 74 20 61 6c 77 61 79 73 0a 2a 2a 20 66  that always.** f
4730: 61 69 6c 73 20 77 69 74 68 20 61 6e 20 65 72 72  ails with an err
4740: 6f 72 20 6d 65 73 73 61 67 65 20 73 74 61 74 69  or message stati
4750: 6e 67 20 74 68 61 74 20 74 68 65 20 66 75 6e 63  ng that the func
4760: 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e 20  tion is used in 
4770: 74 68 65 0a 2a 2a 20 77 72 6f 6e 67 20 63 6f 6e  the.** wrong con
4780: 74 65 78 74 2e 20 20 54 68 65 20 73 71 6c 69 74  text.  The sqlit
4790: 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 6e 63  e3_overload_func
47a0: 74 69 6f 6e 28 29 20 41 50 49 20 6d 69 67 68 74  tion() API might
47b0: 20 63 6f 6e 73 74 72 75 63 74 0a 2a 2a 20 53 51   construct.** SQ
47c0: 4c 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20  L function that 
47d0: 75 73 65 20 74 68 69 73 20 72 6f 75 74 69 6e 65  use this routine
47e0: 20 73 6f 20 74 68 61 74 20 74 68 65 20 66 75 6e   so that the fun
47f0: 63 74 69 6f 6e 73 20 77 69 6c 6c 20 65 78 69 73  ctions will exis
4800: 74 0a 2a 2a 20 66 6f 72 20 6e 61 6d 65 20 72 65  t.** for name re
4810: 73 6f 6c 75 74 69 6f 6e 20 62 75 74 20 61 72 65  solution but are
4820: 20 61 63 74 75 61 6c 6c 79 20 6f 76 65 72 6c 6f   actually overlo
4830: 61 64 65 64 20 62 79 20 74 68 65 20 78 46 69 6e  aded by the xFin
4840: 64 46 75 6e 63 74 69 6f 6e 0a 2a 2a 20 6d 65 74  dFunction.** met
4850: 68 6f 64 20 6f 66 20 76 69 72 74 75 61 6c 20 74  hod of virtual t
4860: 61 62 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ables..*/.void s
4870: 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 75 6e  qlite3InvalidFun
4880: 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33  ction(.  sqlite3
4890: 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  _context *contex
48a0: 74 2c 20 20 2f 2a 20 54 68 65 20 66 75 6e 63 74  t,  /* The funct
48b0: 69 6f 6e 20 63 61 6c 6c 69 6e 67 20 63 6f 6e 74  ion calling cont
48c0: 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 4e 6f 74  ext */.  int Not
48d0: 55 73 65 64 2c 20 20 20 20 20 20 20 20 20 20 20  Used,           
48e0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
48f0: 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 74 68   arguments to th
4900: 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20  e function */.  
4910: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a  sqlite3_value **
4920: 4e 6f 74 55 73 65 64 32 20 20 20 2f 2a 20 56 61  NotUsed2   /* Va
4930: 6c 75 65 20 6f 66 20 65 61 63 68 20 61 72 67 75  lue of each argu
4940: 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e  ment */.){.  con
4950: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 20 3d  st char *zName =
4960: 20 63 6f 6e 74 65 78 74 2d 3e 70 46 75 6e 63 2d   context->pFunc-
4970: 3e 7a 4e 61 6d 65 3b 0a 20 20 63 68 61 72 20 2a  >zName;.  char *
4980: 7a 45 72 72 3b 0a 20 20 55 4e 55 53 45 44 5f 50  zErr;.  UNUSED_P
4990: 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65  ARAMETER2(NotUse
49a0: 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20  d, NotUsed2);.  
49b0: 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d  zErr = sqlite3_m
49c0: 70 72 69 6e 74 66 28 0a 20 20 20 20 20 20 22 75  printf(.      "u
49d0: 6e 61 62 6c 65 20 74 6f 20 75 73 65 20 66 75 6e  nable to use fun
49e0: 63 74 69 6f 6e 20 25 73 20 69 6e 20 74 68 65 20  ction %s in the 
49f0: 72 65 71 75 65 73 74 65 64 20 63 6f 6e 74 65 78  requested contex
4a00: 74 22 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 73 71  t", zName);.  sq
4a10: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
4a20: 6f 72 28 63 6f 6e 74 65 78 74 2c 20 7a 45 72 72  or(context, zErr
4a30: 2c 20 2d 31 29 3b 0a 20 20 73 71 6c 69 74 65 33  , -1);.  sqlite3
4a40: 5f 66 72 65 65 28 7a 45 72 72 29 3b 0a 7d 0a 0a  _free(zErr);.}..
4a50: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f  /*.** Allocate o
4a60: 72 20 72 65 74 75 72 6e 20 74 68 65 20 61 67 67  r return the agg
4a70: 72 65 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66  regate context f
4a80: 6f 72 20 61 20 75 73 65 72 20 66 75 6e 63 74 69  or a user functi
4a90: 6f 6e 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f  on.  A new.** co
4aa0: 6e 74 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74  ntext is allocat
4ab0: 65 64 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20  ed on the first 
4ac0: 63 61 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e  call.  Subsequen
4ad0: 74 20 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74  t calls return t
4ae0: 68 65 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65  he.** same conte
4af0: 78 74 20 74 68 61 74 20 77 61 73 20 72 65 74 75  xt that was retu
4b00: 72 6e 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61  rned on prior ca
4b10: 6c 6c 73 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71  lls..*/.void *sq
4b20: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f  lite3_aggregate_
4b30: 63 6f 6e 74 65 78 74 28 73 71 6c 69 74 65 33 5f  context(sqlite3_
4b40: 63 6f 6e 74 65 78 74 20 2a 70 2c 20 69 6e 74 20  context *p, int 
4b50: 6e 42 79 74 65 29 7b 0a 20 20 4d 65 6d 20 2a 70  nByte){.  Mem *p
4b60: 4d 65 6d 3b 0a 20 20 61 73 73 65 72 74 28 20 70  Mem;.  assert( p
4b70: 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26 20   && p->pFunc && 
4b80: 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74 65 70 20  p->pFunc->xStep 
4b90: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  );.  assert( sql
4ba0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
4bb0: 70 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  p->s.db->mutex) 
4bc0: 29 3b 0a 20 20 70 4d 65 6d 20 3d 20 70 2d 3e 70  );.  pMem = p->p
4bd0: 4d 65 6d 3b 0a 20 20 69 66 28 20 28 70 4d 65 6d  Mem;.  if( (pMem
4be0: 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67  ->flags & MEM_Ag
4bf0: 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28  g)==0 ){.    if(
4c00: 20 6e 42 79 74 65 3d 3d 30 20 29 7b 0a 20 20 20   nByte==0 ){.   
4c10: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
4c20: 6d 52 65 6c 65 61 73 65 45 78 74 65 72 6e 61 6c  mReleaseExternal
4c30: 28 70 4d 65 6d 29 3b 0a 20 20 20 20 20 20 70 4d  (pMem);.      pM
4c40: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
4c50: 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 70 4d 65 6d  Null;.      pMem
4c60: 2d 3e 7a 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c  ->z = 0;.    }el
4c70: 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  se{.      sqlite
4c80: 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 70 4d 65  3VdbeMemGrow(pMe
4c90: 6d 2c 20 6e 42 79 74 65 2c 20 30 29 3b 0a 20 20  m, nByte, 0);.  
4ca0: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
4cb0: 3d 20 4d 45 4d 5f 41 67 67 3b 0a 20 20 20 20 20  = MEM_Agg;.     
4cc0: 20 70 4d 65 6d 2d 3e 75 2e 70 44 65 66 20 3d 20   pMem->u.pDef = 
4cd0: 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20 20 20 20  p->pFunc;.      
4ce0: 69 66 28 20 70 4d 65 6d 2d 3e 7a 20 29 7b 0a 20  if( pMem->z ){. 
4cf0: 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 4d         memset(pM
4d00: 65 6d 2d 3e 7a 2c 20 30 2c 20 6e 42 79 74 65 29  em->z, 0, nByte)
4d10: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
4d20: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 76 6f    }.  return (vo
4d30: 69 64 2a 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a  id*)pMem->z;.}..
4d40: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
4d50: 20 61 75 78 69 6c 61 72 79 20 64 61 74 61 20 70   auxilary data p
4d60: 6f 69 6e 74 65 72 2c 20 69 66 20 61 6e 79 2c 20  ointer, if any, 
4d70: 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 68 20  for the iArg'th 
4d80: 61 72 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74  argument to.** t
4d90: 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e  he user-function
4da0: 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 74 78   defined by pCtx
4db0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
4dc0: 65 33 5f 67 65 74 5f 61 75 78 64 61 74 61 28 73  e3_get_auxdata(s
4dd0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
4de0: 70 43 74 78 2c 20 69 6e 74 20 69 41 72 67 29 7b  pCtx, int iArg){
4df0: 0a 20 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64  .  VdbeFunc *pVd
4e00: 62 65 46 75 6e 63 3b 0a 0a 20 20 61 73 73 65 72  beFunc;..  asser
4e10: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
4e20: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62  _held(pCtx->s.db
4e30: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 56  ->mutex) );.  pV
4e40: 64 62 65 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e  dbeFunc = pCtx->
4e50: 70 56 64 62 65 46 75 6e 63 3b 0a 20 20 69 66 28  pVdbeFunc;.  if(
4e60: 20 21 70 56 64 62 65 46 75 6e 63 20 7c 7c 20 69   !pVdbeFunc || i
4e70: 41 72 67 3e 3d 70 56 64 62 65 46 75 6e 63 2d 3e  Arg>=pVdbeFunc->
4e80: 6e 41 75 78 20 7c 7c 20 69 41 72 67 3c 30 20 29  nAux || iArg<0 )
4e90: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  {.    return 0;.
4ea0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 56 64    }.  return pVd
4eb0: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41  beFunc->apAux[iA
4ec0: 72 67 5d 2e 70 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a  rg].pAux;.}../*.
4ed0: 2a 2a 20 53 65 74 20 74 68 65 20 61 75 78 69 6c  ** Set the auxil
4ee0: 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72  ary data pointer
4ef0: 20 61 6e 64 20 64 65 6c 65 74 65 20 66 75 6e 63   and delete func
4f00: 74 69 6f 6e 2c 20 66 6f 72 20 74 68 65 20 69 41  tion, for the iA
4f10: 72 67 27 74 68 0a 2a 2a 20 61 72 67 75 6d 65 6e  rg'th.** argumen
4f20: 74 20 74 6f 20 74 68 65 20 75 73 65 72 2d 66 75  t to the user-fu
4f30: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 65 64 20 62  nction defined b
4f40: 79 20 70 43 74 78 2e 20 41 6e 79 20 70 72 65 76  y pCtx. Any prev
4f50: 69 6f 75 73 20 76 61 6c 75 65 20 69 73 0a 2a 2a  ious value is.**
4f60: 20 64 65 6c 65 74 65 64 20 62 79 20 63 61 6c 6c   deleted by call
4f70: 69 6e 67 20 74 68 65 20 64 65 6c 65 74 65 20 66  ing the delete f
4f80: 75 6e 63 74 69 6f 6e 20 73 70 65 63 69 66 69 65  unction specifie
4f90: 64 20 77 68 65 6e 20 69 74 20 77 61 73 20 73 65  d when it was se
4fa0: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
4fb0: 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28 0a  e3_set_auxdata(.
4fc0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
4fd0: 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74 20  t *pCtx, .  int 
4fe0: 69 41 72 67 2c 20 0a 20 20 76 6f 69 64 20 2a 70  iArg, .  void *p
4ff0: 41 75 78 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  Aux, .  void (*x
5000: 44 65 6c 65 74 65 29 28 76 6f 69 64 2a 29 0a 29  Delete)(void*).)
5010: 7b 0a 20 20 73 74 72 75 63 74 20 41 75 78 44 61  {.  struct AuxDa
5020: 74 61 20 2a 70 41 75 78 44 61 74 61 3b 0a 20 20  ta *pAuxData;.  
5030: 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46  VdbeFunc *pVdbeF
5040: 75 6e 63 3b 0a 20 20 69 66 28 20 69 41 72 67 3c  unc;.  if( iArg<
5050: 30 20 29 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b  0 ) goto failed;
5060: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ..  assert( sqli
5070: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
5080: 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78  Ctx->s.db->mutex
5090: 29 20 29 3b 0a 20 20 70 56 64 62 65 46 75 6e 63  ) );.  pVdbeFunc
50a0: 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65 46 75   = pCtx->pVdbeFu
50b0: 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64 62 65  nc;.  if( !pVdbe
50c0: 46 75 6e 63 20 7c 7c 20 70 56 64 62 65 46 75 6e  Func || pVdbeFun
50d0: 63 2d 3e 6e 41 75 78 3c 3d 69 41 72 67 20 29 7b  c->nAux<=iArg ){
50e0: 0a 20 20 20 20 69 6e 74 20 6e 41 75 78 20 3d 20  .    int nAux = 
50f0: 28 70 56 64 62 65 46 75 6e 63 20 3f 20 70 56 64  (pVdbeFunc ? pVd
5100: 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3a 20 30  beFunc->nAux : 0
5110: 29 3b 0a 20 20 20 20 69 6e 74 20 6e 4d 61 6c 6c  );.    int nMall
5120: 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 64 62 65  oc = sizeof(Vdbe
5130: 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f 66 28 73  Func) + sizeof(s
5140: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 69  truct AuxData)*i
5150: 41 72 67 3b 0a 20 20 20 20 70 56 64 62 65 46 75  Arg;.    pVdbeFu
5160: 6e 63 20 3d 20 73 71 6c 69 74 65 33 44 62 52 65  nc = sqlite3DbRe
5170: 61 6c 6c 6f 63 28 70 43 74 78 2d 3e 73 2e 64 62  alloc(pCtx->s.db
5180: 2c 20 70 56 64 62 65 46 75 6e 63 2c 20 6e 4d 61  , pVdbeFunc, nMa
5190: 6c 6c 6f 63 29 3b 0a 20 20 20 20 69 66 28 20 21  lloc);.    if( !
51a0: 70 56 64 62 65 46 75 6e 63 20 29 7b 0a 20 20 20  pVdbeFunc ){.   
51b0: 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a     goto failed;.
51c0: 20 20 20 20 7d 0a 20 20 20 20 70 43 74 78 2d 3e      }.    pCtx->
51d0: 70 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64 62  pVdbeFunc = pVdb
51e0: 65 46 75 6e 63 3b 0a 20 20 20 20 6d 65 6d 73 65  eFunc;.    memse
51f0: 74 28 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70  t(&pVdbeFunc->ap
5200: 41 75 78 5b 6e 41 75 78 5d 2c 20 30 2c 20 73 69  Aux[nAux], 0, si
5210: 7a 65 6f 66 28 73 74 72 75 63 74 20 41 75 78 44  zeof(struct AuxD
5220: 61 74 61 29 2a 28 69 41 72 67 2b 31 2d 6e 41 75  ata)*(iArg+1-nAu
5230: 78 29 29 3b 0a 20 20 20 20 70 56 64 62 65 46 75  x));.    pVdbeFu
5240: 6e 63 2d 3e 6e 41 75 78 20 3d 20 69 41 72 67 2b  nc->nAux = iArg+
5250: 31 3b 0a 20 20 20 20 70 56 64 62 65 46 75 6e 63  1;.    pVdbeFunc
5260: 2d 3e 70 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e  ->pFunc = pCtx->
5270: 70 46 75 6e 63 3b 0a 20 20 7d 0a 0a 20 20 70 41  pFunc;.  }..  pA
5280: 75 78 44 61 74 61 20 3d 20 26 70 56 64 62 65 46  uxData = &pVdbeF
5290: 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d  unc->apAux[iArg]
52a0: 3b 0a 20 20 69 66 28 20 70 41 75 78 44 61 74 61  ;.  if( pAuxData
52b0: 2d 3e 70 41 75 78 20 26 26 20 70 41 75 78 44 61  ->pAux && pAuxDa
52c0: 74 61 2d 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20  ta->xDelete ){. 
52d0: 20 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44 65     pAuxData->xDe
52e0: 6c 65 74 65 28 70 41 75 78 44 61 74 61 2d 3e 70  lete(pAuxData->p
52f0: 41 75 78 29 3b 0a 20 20 7d 0a 20 20 70 41 75 78  Aux);.  }.  pAux
5300: 44 61 74 61 2d 3e 70 41 75 78 20 3d 20 70 41 75  Data->pAux = pAu
5310: 78 3b 0a 20 20 70 41 75 78 44 61 74 61 2d 3e 78  x;.  pAuxData->x
5320: 44 65 6c 65 74 65 20 3d 20 78 44 65 6c 65 74 65  Delete = xDelete
5330: 3b 0a 20 20 72 65 74 75 72 6e 3b 0a 0a 66 61 69  ;.  return;..fai
5340: 6c 65 64 3a 0a 20 20 69 66 28 20 78 44 65 6c 65  led:.  if( xDele
5350: 74 65 20 29 7b 0a 20 20 20 20 78 44 65 6c 65 74  te ){.    xDelet
5360: 65 28 70 41 75 78 29 3b 0a 20 20 7d 0a 7d 0a 0a  e(pAux);.  }.}..
5370: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
5380: 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f  MIT_DEPRECATED./
5390: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
53a0: 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20  number of times 
53b0: 74 68 65 20 53 74 65 70 20 66 75 6e 63 74 69 6f  the Step functio
53c0: 6e 20 6f 66 20 61 20 61 67 67 72 65 67 61 74 65  n of a aggregate
53d0: 20 68 61 73 20 62 65 65 6e 20 0a 2a 2a 20 63 61   has been .** ca
53e0: 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  lled..**.** This
53f0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 64 65 70   function is dep
5400: 72 65 63 61 74 65 64 2e 20 20 44 6f 20 6e 6f 74  recated.  Do not
5410: 20 75 73 65 20 69 74 20 66 6f 72 20 6e 65 77 20   use it for new 
5420: 63 6f 64 65 2e 20 20 49 74 20 69 73 0a 2a 2a 20  code.  It is.** 
5430: 70 72 6f 76 69 64 65 20 6f 6e 6c 79 20 74 6f 20  provide only to 
5440: 61 76 6f 69 64 20 62 72 65 61 6b 69 6e 67 20 6c  avoid breaking l
5450: 65 67 61 63 79 20 63 6f 64 65 2e 20 20 4e 65 77  egacy code.  New
5460: 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74   aggregate funct
5470: 69 6f 6e 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74  ion.** implement
5480: 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 6b 65  ations should ke
5490: 65 70 20 74 68 65 69 72 20 6f 77 6e 20 63 6f 75  ep their own cou
54a0: 6e 74 73 20 77 69 74 68 69 6e 20 74 68 65 69 72  nts within their
54b0: 20 61 67 67 72 65 67 61 74 65 0a 2a 2a 20 63 6f   aggregate.** co
54c0: 6e 74 65 78 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ntext..*/.int sq
54d0: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f  lite3_aggregate_
54e0: 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f  count(sqlite3_co
54f0: 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 61 73 73  ntext *p){.  ass
5500: 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70 4d 65  ert( p && p->pMe
5510: 6d 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26  m && p->pFunc &&
5520: 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74 65 70   p->pFunc->xStep
5530: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e   );.  return p->
5540: 70 4d 65 6d 2d 3e 6e 3b 0a 7d 0a 23 65 6e 64 69  pMem->n;.}.#endi
5550: 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  f../*.** Return 
5560: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
5570: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 65 73  lumns in the res
5580: 75 6c 74 20 73 65 74 20 66 6f 72 20 74 68 65 20  ult set for the 
5590: 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e  statement pStmt.
55a0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
55b0: 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 73 71 6c  column_count(sql
55c0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
55d0: 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 3d  ){.  Vdbe *pVm =
55e0: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
55f0: 20 20 72 65 74 75 72 6e 20 70 56 6d 20 3f 20 70    return pVm ? p
5600: 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3a  Vm->nResColumn :
5610: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74   0;.}../*.** Ret
5620: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
5630: 66 20 76 61 6c 75 65 73 20 61 76 61 69 6c 61 62  f values availab
5640: 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72  le from the curr
5650: 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 65 0a 2a  ent row of the.*
5660: 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 63  * currently exec
5670: 75 74 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20  uting statement 
5680: 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  pStmt..*/.int sq
5690: 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74  lite3_data_count
56a0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
56b0: 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70  Stmt){.  Vdbe *p
56c0: 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74  Vm = (Vdbe *)pSt
56d0: 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d 3d 30  mt;.  if( pVm==0
56e0: 20 7c 7c 20 70 56 6d 2d 3e 70 52 65 73 75 6c 74   || pVm->pResult
56f0: 53 65 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  Set==0 ) return 
5700: 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 2d  0;.  return pVm-
5710: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a 0a  >nResColumn;.}..
5720: 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20  ./*.** Check to 
5730: 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 43  see if column iC
5740: 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e 20  ol of the given 
5750: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61 6c  statement is val
5760: 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69 73  id.  If.** it is
5770: 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  , return a point
5780: 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66 6f  er to the Mem fo
5790: 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  r the value of t
57a0: 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 49  hat column..** I
57b0: 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76 61  f iCol is not va
57c0: 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70 6f  lid, return a po
57d0: 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20 77  inter to a Mem w
57e0: 68 69 63 68 20 68 61 73 20 61 20 76 61 6c 75 65  hich has a value
57f0: 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f 0a  .** of NULL..*/.
5800: 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c 75  static Mem *colu
5810: 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73 74  mnMem(sqlite3_st
5820: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
5830: 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 3b 0a  ){.  Vdbe *pVm;.
5840: 20 20 69 6e 74 20 76 61 6c 73 3b 0a 20 20 4d 65    int vals;.  Me
5850: 6d 20 2a 70 4f 75 74 3b 0a 0a 20 20 70 56 6d 20  m *pOut;..  pVm 
5860: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
5870: 0a 20 20 69 66 28 20 70 56 6d 20 26 26 20 70 56  .  if( pVm && pV
5880: 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 21 3d 30  m->pResultSet!=0
5890: 20 26 26 20 69 3c 70 56 6d 2d 3e 6e 52 65 73 43   && i<pVm->nResC
58a0: 6f 6c 75 6d 6e 20 26 26 20 69 3e 3d 30 20 29 7b  olumn && i>=0 ){
58b0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
58c0: 65 78 5f 65 6e 74 65 72 28 70 56 6d 2d 3e 64 62  ex_enter(pVm->db
58d0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 76 61  ->mutex);.    va
58e0: 6c 73 20 3d 20 73 71 6c 69 74 65 33 5f 64 61 74  ls = sqlite3_dat
58f0: 61 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a  a_count(pStmt);.
5900: 20 20 20 20 70 4f 75 74 20 3d 20 26 70 56 6d 2d      pOut = &pVm-
5910: 3e 70 52 65 73 75 6c 74 53 65 74 5b 69 5d 3b 0a  >pResultSet[i];.
5920: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20    }else{.    /* 
5930: 28 28 64 6f 75 62 6c 65 29 30 29 20 49 6e 20 63  ((double)0) In c
5940: 61 73 65 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4d  ase of SQLITE_OM
5950: 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e  IT_FLOATING_POIN
5960: 54 2e 2e 2e 20 2a 2f 0a 20 20 20 20 73 74 61 74  T... */.    stat
5970: 69 63 20 63 6f 6e 73 74 20 4d 65 6d 20 6e 75 6c  ic const Mem nul
5980: 6c 4d 65 6d 20 3d 20 7b 7b 30 7d 2c 20 28 64 6f  lMem = {{0}, (do
5990: 75 62 6c 65 29 30 2c 20 30 2c 20 22 22 2c 20 30  uble)0, 0, "", 0
59a0: 2c 20 4d 45 4d 5f 4e 75 6c 6c 2c 20 53 51 4c 49  , MEM_Null, SQLI
59b0: 54 45 5f 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20 30  TE_NULL, 0, 0, 0
59c0: 20 7d 3b 0a 20 20 20 20 69 66 28 20 70 56 6d 20   };.    if( pVm 
59d0: 26 26 20 70 56 6d 2d 3e 64 62 20 29 7b 0a 20 20  && pVm->db ){.  
59e0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
59f0: 78 5f 65 6e 74 65 72 28 70 56 6d 2d 3e 64 62 2d  x_enter(pVm->db-
5a00: 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 73  >mutex);.      s
5a10: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 56 6d 2d  qlite3Error(pVm-
5a20: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47  >db, SQLITE_RANG
5a30: 45 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20  E, 0);.    }.   
5a40: 20 70 4f 75 74 20 3d 20 28 4d 65 6d 2a 29 26 6e   pOut = (Mem*)&n
5a50: 75 6c 6c 4d 65 6d 3b 0a 20 20 7d 0a 20 20 72 65  ullMem;.  }.  re
5a60: 74 75 72 6e 20 70 4f 75 74 3b 0a 7d 0a 0a 2f 2a  turn pOut;.}../*
5a70: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
5a80: 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 66 74 65  n is called afte
5a90: 72 20 69 6e 76 6f 6b 69 6e 67 20 61 6e 20 73 71  r invoking an sq
5aa0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 58 58 58 20  lite3_value_XXX 
5ab0: 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 61 20 0a 2a  function on a .*
5ac0: 2a 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 20 28  * column value (
5ad0: 69 2e 65 2e 20 61 20 76 61 6c 75 65 20 72 65 74  i.e. a value ret
5ae0: 75 72 6e 65 64 20 62 79 20 65 76 61 6c 75 61 74  urned by evaluat
5af0: 69 6e 67 20 61 6e 20 53 51 4c 20 65 78 70 72 65  ing an SQL expre
5b00: 73 73 69 6f 6e 20 69 6e 20 74 68 65 0a 2a 2a 20  ssion in the.** 
5b10: 73 65 6c 65 63 74 20 6c 69 73 74 20 6f 66 20 61  select list of a
5b20: 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e   SELECT statemen
5b30: 74 29 20 74 68 61 74 20 6d 61 79 20 63 61 75 73  t) that may caus
5b40: 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69  e a malloc() fai
5b50: 6c 75 72 65 2e 20 49 66 20 0a 2a 2a 20 6d 61 6c  lure. If .** mal
5b60: 6c 6f 63 28 29 20 68 61 73 20 66 61 69 6c 65 64  loc() has failed
5b70: 2c 20 74 68 65 20 74 68 72 65 61 64 73 20 6d 61  , the threads ma
5b80: 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20  llocFailed flag 
5b90: 69 73 20 63 6c 65 61 72 65 64 20 61 6e 64 20 74  is cleared and t
5ba0: 68 65 20 72 65 73 75 6c 74 0a 2a 2a 20 63 6f 64  he result.** cod
5bb0: 65 20 6f 66 20 73 74 61 74 65 6d 65 6e 74 20 70  e of statement p
5bc0: 53 74 6d 74 20 73 65 74 20 74 6f 20 53 51 4c 49  Stmt set to SQLI
5bd0: 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2a 0a 2a 2a 20  TE_NOMEM..**.** 
5be0: 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68  Specifically, th
5bf0: 69 73 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f  is is called fro
5c00: 6d 20 77 69 74 68 69 6e 3a 0a 2a 2a 0a 2a 2a 20  m within:.**.** 
5c10: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75      sqlite3_colu
5c20: 6d 6e 5f 69 6e 74 28 29 0a 2a 2a 20 20 20 20 20  mn_int().**     
5c30: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69  sqlite3_column_i
5c40: 6e 74 36 34 28 29 0a 2a 2a 20 20 20 20 20 73 71  nt64().**     sq
5c50: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78  lite3_column_tex
5c60: 74 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74  t().**     sqlit
5c70: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36  e3_column_text16
5c80: 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  ().**     sqlite
5c90: 33 5f 63 6f 6c 75 6d 6e 5f 72 65 61 6c 28 29 0a  3_column_real().
5ca0: 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63  **     sqlite3_c
5cb0: 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 29 0a 2a 2a  olumn_bytes().**
5cc0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c       sqlite3_col
5cd0: 75 6d 6e 5f 62 79 74 65 73 31 36 28 29 0a 2a 2a  umn_bytes16().**
5ce0: 0a 2a 2a 20 42 75 74 20 6e 6f 74 20 66 6f 72 20  .** But not for 
5cf0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62  sqlite3_column_b
5d00: 6c 6f 62 28 29 2c 20 77 68 69 63 68 20 6e 65 76  lob(), which nev
5d10: 65 72 20 63 61 6c 6c 73 20 6d 61 6c 6c 6f 63 28  er calls malloc(
5d20: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  )..*/.static voi
5d30: 64 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61  d columnMallocFa
5d40: 69 6c 75 72 65 28 73 71 6c 69 74 65 33 5f 73 74  ilure(sqlite3_st
5d50: 6d 74 20 2a 70 53 74 6d 74 29 0a 7b 0a 20 20 2f  mt *pStmt).{.  /
5d60: 2a 20 49 66 20 6d 61 6c 6c 6f 63 28 29 20 66 61  * If malloc() fa
5d70: 69 6c 65 64 20 64 75 72 69 6e 67 20 61 6e 20 65  iled during an e
5d80: 6e 63 6f 64 69 6e 67 20 63 6f 6e 76 65 72 73 69  ncoding conversi
5d90: 6f 6e 20 77 69 74 68 69 6e 20 61 6e 0a 20 20 2a  on within an.  *
5da0: 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  * sqlite3_column
5db0: 5f 58 58 58 20 41 50 49 2c 20 74 68 65 6e 20 73  _XXX API, then s
5dc0: 65 74 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f  et the return co
5dd0: 64 65 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d  de of the statem
5de0: 65 6e 74 20 74 6f 0a 20 20 2a 2a 20 53 51 4c 49  ent to.  ** SQLI
5df0: 54 45 5f 4e 4f 4d 45 4d 2e 20 54 68 65 20 6e 65  TE_NOMEM. The ne
5e00: 78 74 20 63 61 6c 6c 20 74 6f 20 5f 73 74 65 70  xt call to _step
5e10: 28 29 20 28 69 66 20 61 6e 79 29 20 77 69 6c 6c  () (if any) will
5e20: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
5e30: 52 52 4f 52 0a 20 20 2a 2a 20 61 6e 64 20 5f 66  RROR.  ** and _f
5e40: 69 6e 61 6c 69 7a 65 28 29 20 77 69 6c 6c 20 72  inalize() will r
5e50: 65 74 75 72 6e 20 4e 4f 4d 45 4d 2e 0a 20 20 2a  eturn NOMEM..  *
5e60: 2f 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  /.  Vdbe *p = (V
5e70: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69  dbe *)pStmt;.  i
5e80: 66 28 20 70 20 29 7b 0a 20 20 20 20 70 2d 3e 72  f( p ){.    p->r
5e90: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
5ea0: 69 74 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 29  it(p->db, p->rc)
5eb0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
5ec0: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d  tex_leave(p->db-
5ed0: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a 0a  >mutex);.  }.}..
5ee0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
5ef0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71  ************* sq
5f00: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a  lite3_column_  *
5f10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5f20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
5f30: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
5f40: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 65  routines are use
5f50: 64 20 74 6f 20 61 63 63 65 73 73 20 65 6c 65 6d  d to access elem
5f60: 65 6e 74 73 20 6f 66 20 74 68 65 20 63 75 72 72  ents of the curr
5f70: 65 6e 74 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68  ent row.** in th
5f80: 65 20 72 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f  e result set..*/
5f90: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
5fa0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62  ite3_column_blob
5fb0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
5fc0: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
5fd0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c 3b  const void *val;
5fe0: 0a 20 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33  .  val = sqlite3
5ff0: 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 20 63 6f 6c  _value_blob( col
6000: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
6010: 29 3b 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f  );.  /* Even tho
6020: 75 67 68 20 74 68 65 72 65 20 69 73 20 6e 6f 20  ugh there is no 
6030: 65 6e 63 6f 64 69 6e 67 20 63 6f 6e 76 65 72 73  encoding convers
6040: 69 6f 6e 2c 20 76 61 6c 75 65 5f 62 6c 6f 62 28  ion, value_blob(
6050: 29 20 6d 69 67 68 74 0a 20 20 2a 2a 20 6e 65 65  ) might.  ** nee
6060: 64 20 74 6f 20 63 61 6c 6c 20 6d 61 6c 6c 6f 63  d to call malloc
6070: 28 29 20 74 6f 20 65 78 70 61 6e 64 20 74 68 65  () to expand the
6080: 20 72 65 73 75 6c 74 20 6f 66 20 61 20 7a 65 72   result of a zer
6090: 6f 62 6c 6f 62 28 29 20 0a 20 20 2a 2a 20 65 78  oblob() .  ** ex
60a0: 70 72 65 73 73 69 6f 6e 2e 20 0a 20 20 2a 2f 0a  pression. .  */.
60b0: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61    columnMallocFa
60c0: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20  ilure(pStmt);.  
60d0: 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e  return val;.}.in
60e0: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  t sqlite3_column
60f0: 5f 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f 73  _bytes(sqlite3_s
6100: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
6110: 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20  i){.  int val = 
6120: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79  sqlite3_value_by
6130: 74 65 73 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70  tes( columnMem(p
6140: 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c  Stmt,i) );.  col
6150: 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65  umnMallocFailure
6160: 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72  (pStmt);.  retur
6170: 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71 6c  n val;.}.int sql
6180: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
6190: 73 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  s16(sqlite3_stmt
61a0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
61b0: 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c  .  int val = sql
61c0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73  ite3_value_bytes
61d0: 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  16( columnMem(pS
61e0: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75  tmt,i) );.  colu
61f0: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28  mnMallocFailure(
6200: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
6210: 20 76 61 6c 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73   val;.}.double s
6220: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f  qlite3_column_do
6230: 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  uble(sqlite3_stm
6240: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
6250: 7b 0a 20 20 64 6f 75 62 6c 65 20 76 61 6c 20 3d  {.  double val =
6260: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64   sqlite3_value_d
6270: 6f 75 62 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d  ouble( columnMem
6280: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63  (pStmt,i) );.  c
6290: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75  olumnMallocFailu
62a0: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74  re(pStmt);.  ret
62b0: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73  urn val;.}.int s
62c0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e  qlite3_column_in
62d0: 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  t(sqlite3_stmt *
62e0: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
62f0: 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c 69 74   int val = sqlit
6300: 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 20 63 6f  e3_value_int( co
6310: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
6320: 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c   );.  columnMall
6330: 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29  ocFailure(pStmt)
6340: 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a  ;.  return val;.
6350: 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73  }.sqlite_int64 s
6360: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e  qlite3_column_in
6370: 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  t64(sqlite3_stmt
6380: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
6390: 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  .  sqlite_int64 
63a0: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  val = sqlite3_va
63b0: 6c 75 65 5f 69 6e 74 36 34 28 20 63 6f 6c 75 6d  lue_int64( colum
63c0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
63d0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
63e0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
63f0: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 63   return val;.}.c
6400: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
6410: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ar *sqlite3_colu
6420: 6d 6e 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f  mn_text(sqlite3_
6430: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
6440: 20 69 29 7b 0a 20 20 63 6f 6e 73 74 20 75 6e 73   i){.  const uns
6450: 69 67 6e 65 64 20 63 68 61 72 20 2a 76 61 6c 20  igned char *val 
6460: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
6470: 74 65 78 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  text( columnMem(
6480: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f  pStmt,i) );.  co
6490: 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72  lumnMallocFailur
64a0: 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75  e(pStmt);.  retu
64b0: 72 6e 20 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65  rn val;.}.sqlite
64c0: 33 5f 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33  3_value *sqlite3
64d0: 5f 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71  _column_value(sq
64e0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
64f0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d  t, int i){.  Mem
6500: 20 2a 70 4f 75 74 20 3d 20 63 6f 6c 75 6d 6e 4d   *pOut = columnM
6510: 65 6d 28 70 53 74 6d 74 2c 20 69 29 3b 0a 20 20  em(pStmt, i);.  
6520: 69 66 28 20 70 4f 75 74 2d 3e 66 6c 61 67 73 26  if( pOut->flags&
6530: 4d 45 4d 5f 53 74 61 74 69 63 20 29 7b 0a 20 20  MEM_Static ){.  
6540: 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 26 3d    pOut->flags &=
6550: 20 7e 4d 45 4d 5f 53 74 61 74 69 63 3b 0a 20 20   ~MEM_Static;.  
6560: 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 7c 3d    pOut->flags |=
6570: 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 7d 0a   MEM_Ephem;.  }.
6580: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61    columnMallocFa
6590: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20  ilure(pStmt);.  
65a0: 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 5f  return (sqlite3_
65b0: 76 61 6c 75 65 20 2a 29 70 4f 75 74 3b 0a 7d 0a  value *)pOut;.}.
65c0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
65d0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
65e0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
65f0: 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c 69  lumn_text16(sqli
6600: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
6610: 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e 73 74   int i){.  const
6620: 20 76 6f 69 64 20 2a 76 61 6c 20 3d 20 73 71 6c   void *val = sql
6630: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
6640: 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  6( columnMem(pSt
6650: 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d  mt,i) );.  colum
6660: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70  nMallocFailure(p
6670: 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20  Stmt);.  return 
6680: 76 61 6c 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a  val;.}.#endif /*
6690: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
66a0: 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  16 */.int sqlite
66b0: 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73 71  3_column_type(sq
66c0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
66d0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74  t, int i){.  int
66e0: 20 69 54 79 70 65 20 3d 20 73 71 6c 69 74 65 33   iType = sqlite3
66f0: 5f 76 61 6c 75 65 5f 74 79 70 65 28 20 63 6f 6c  _value_type( col
6700: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
6710: 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f  );.  columnMallo
6720: 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b  cFailure(pStmt);
6730: 0a 20 20 72 65 74 75 72 6e 20 69 54 79 70 65 3b  .  return iType;
6740: 0a 7d 0a 0a 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f  .}../* The follo
6750: 77 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73  wing function is
6760: 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e   experimental an
6770: 64 20 73 75 62 6a 65 63 74 20 74 6f 20 63 68 61  d subject to cha
6780: 6e 67 65 20 6f 72 0a 2a 2a 20 72 65 6d 6f 76 61  nge or.** remova
6790: 6c 20 2a 2f 0a 2f 2a 69 6e 74 20 73 71 6c 69 74  l */./*int sqlit
67a0: 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 75 6d 65 72 69  e3_column_numeri
67b0: 63 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73  c_type(sqlite3_s
67c0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
67d0: 69 29 7b 0a 2a 2a 20 20 72 65 74 75 72 6e 20 73  i){.**  return s
67e0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 6e 75 6d  qlite3_value_num
67f0: 65 72 69 63 5f 74 79 70 65 28 20 63 6f 6c 75 6d  eric_type( colum
6800: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
6810: 0a 2a 2a 7d 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43  .**}.*/../*.** C
6820: 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d 74 68 20  onvert the N-th 
6830: 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 74 6d 74  element of pStmt
6840: 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 69 6e 74  ->pColName[] int
6850: 6f 20 61 20 73 74 72 69 6e 67 20 75 73 69 6e 67  o a string using
6860: 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 68 65 6e  .** xFunc() then
6870: 20 72 65 74 75 72 6e 20 74 68 61 74 20 73 74 72   return that str
6880: 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20 6f 75  ing.  If N is ou
6890: 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 65 74 75  t of range, retu
68a0: 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72  rn 0..**.** Ther
68b0: 65 20 61 72 65 20 75 70 20 74 6f 20 35 20 6e 61  e are up to 5 na
68c0: 6d 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f 6c  mes for each col
68d0: 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 20 64 65  umn.  useType de
68e0: 74 65 72 6d 69 6e 65 73 20 77 68 69 63 68 0a 2a  termines which.*
68f0: 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 75 72 6e  * name is return
6900: 65 64 2e 20 20 48 65 72 65 20 61 72 65 20 74 68  ed.  Here are th
6910: 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 20  e names:.**.**  
6920: 20 20 30 20 20 20 20 20 20 54 68 65 20 63 6f 6c    0      The col
6930: 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 74 20 73  umn name as it s
6940: 68 6f 75 6c 64 20 62 65 20 64 69 73 70 6c 61 79  hould be display
6950: 65 64 20 66 6f 72 20 6f 75 74 70 75 74 0a 2a 2a  ed for output.**
6960: 20 20 20 20 31 20 20 20 20 20 20 54 68 65 20 64      1      The d
6970: 61 74 61 74 79 70 65 20 6e 61 6d 65 20 66 6f 72  atatype name for
6980: 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 20   the column.**  
6990: 20 20 32 20 20 20 20 20 20 54 68 65 20 6e 61 6d    2      The nam
69a0: 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  e of the databas
69b0: 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 6d  e that the colum
69c0: 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a  n derives from.*
69d0: 2a 20 20 20 20 33 20 20 20 20 20 20 54 68 65 20  *    3      The 
69e0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
69f0: 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 6d  e that the colum
6a00: 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a  n derives from.*
6a10: 2a 20 20 20 20 34 20 20 20 20 20 20 54 68 65 20  *    4      The 
6a20: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
6a30: 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74 68  e column that th
6a40: 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20  e result column 
6a50: 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a 0a  derives from.**.
6a60: 2a 2a 20 49 66 20 74 68 65 20 72 65 73 75 6c 74  ** If the result
6a70: 20 69 73 20 6e 6f 74 20 61 20 73 69 6d 70 6c 65   is not a simple
6a80: 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 6e 63   column referenc
6a90: 65 20 28 69 66 20 69 74 20 69 73 20 61 6e 20 65  e (if it is an e
6aa0: 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 6f 72 20  xpression.** or 
6ab0: 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 68 65 6e  a constant) then
6ac0: 20 75 73 65 54 79 70 65 73 20 32 2c 20 33 2c 20   useTypes 2, 3, 
6ad0: 61 6e 64 20 34 20 72 65 74 75 72 6e 20 4e 55 4c  and 4 return NUL
6ae0: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e  L..*/.static con
6af0: 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 6d 6e 4e  st void *columnN
6b00: 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  ame(.  sqlite3_s
6b10: 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 20 69 6e  tmt *pStmt,.  in
6b20: 74 20 4e 2c 0a 20 20 63 6f 6e 73 74 20 76 6f 69  t N,.  const voi
6b30: 64 20 2a 28 2a 78 46 75 6e 63 29 28 4d 65 6d 2a  d *(*xFunc)(Mem*
6b40: 29 2c 0a 20 20 69 6e 74 20 75 73 65 54 79 70 65  ),.  int useType
6b50: 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  .){.  const void
6b60: 20 2a 72 65 74 20 3d 20 30 3b 0a 20 20 56 64 62   *ret = 0;.  Vdb
6b70: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
6b80: 53 74 6d 74 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20  Stmt;.  int n;. 
6b90: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
6ba0: 2d 3e 64 62 3b 0a 20 20 0a 0a 20 20 69 66 28 20  ->db;.  ..  if( 
6bb0: 70 21 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65  p!=0 ){.    asse
6bc0: 72 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20 20  rt( db!=0 );.   
6bd0: 20 6e 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c   n = sqlite3_col
6be0: 75 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29  umn_count(pStmt)
6bf0: 3b 0a 20 20 20 20 69 66 28 20 4e 3c 6e 20 26 26  ;.    if( N<n &&
6c00: 20 4e 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 4e   N>=0 ){.      N
6c10: 20 2b 3d 20 75 73 65 54 79 70 65 2a 6e 3b 0a 20   += useType*n;. 
6c20: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74       sqlite3_mut
6c30: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74  ex_enter(db->mut
6c40: 65 78 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  ex);.      asser
6c50: 74 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  t( db->mallocFai
6c60: 6c 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20  led==0 );.      
6c70: 72 65 74 20 3d 20 78 46 75 6e 63 28 26 70 2d 3e  ret = xFunc(&p->
6c80: 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a 0a 20  aColName[N]);.. 
6c90: 20 20 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63       /* A malloc
6ca0: 20 6d 61 79 20 68 61 76 65 20 66 61 69 6c 65 64   may have failed
6cb0: 20 69 6e 73 69 64 65 20 6f 66 20 74 68 65 20 78   inside of the x
6cc0: 46 75 6e 63 28 29 20 63 61 6c 6c 2e 20 49 66 20  Func() call. If 
6cd0: 74 68 69 73 0a 20 20 20 20 20 20 2a 2a 20 69 73  this.      ** is
6ce0: 20 74 68 65 20 63 61 73 65 2c 20 63 6c 65 61 72   the case, clear
6cf0: 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65   the mallocFaile
6d00: 64 20 66 6c 61 67 20 61 6e 64 20 72 65 74 75 72  d flag and retur
6d10: 6e 20 4e 55 4c 4c 2e 0a 20 20 20 20 20 20 2a 2f  n NULL..      */
6d20: 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 6d  .      if( db->m
6d30: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20  allocFailed ){. 
6d40: 20 20 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f         db->mallo
6d50: 63 46 61 69 6c 65 64 20 3d 20 30 3b 0a 20 20 20  cFailed = 0;.   
6d60: 20 20 20 20 20 72 65 74 20 3d 20 30 3b 0a 20 20       ret = 0;.  
6d70: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
6d80: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
6d90: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20  db->mutex);.    
6da0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  }.  }.  return r
6db0: 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  et;.}../*.** Ret
6dc0: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  urn the name of 
6dd0: 74 68 65 20 4e 74 68 20 63 6f 6c 75 6d 6e 20 6f  the Nth column o
6de0: 66 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74  f the result set
6df0: 20 72 65 74 75 72 6e 65 64 20 62 79 20 53 51 4c   returned by SQL
6e00: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 53  .** statement pS
6e10: 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  tmt..*/.const ch
6e20: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ar *sqlite3_colu
6e30: 6d 6e 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f  mn_name(sqlite3_
6e40: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
6e50: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   N){.  return co
6e60: 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20  lumnName(.      
6e70: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74  pStmt, N, (const
6e80: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29   void*(*)(Mem*))
6e90: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
6ea0: 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45  xt, COLNAME_NAME
6eb0: 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  );.}.#ifndef SQL
6ec0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63  ITE_OMIT_UTF16.c
6ed0: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
6ee0: 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36  e3_column_name16
6ef0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
6f00: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  Stmt, int N){.  
6f10: 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d  return columnNam
6f20: 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20  e(.      pStmt, 
6f30: 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28  N, (const void*(
6f40: 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33  *)(Mem*))sqlite3
6f50: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 43  _value_text16, C
6f60: 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a  OLNAME_NAME);.}.
6f70: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f  #endif../*.** Co
6f80: 6e 73 74 72 61 69 6e 74 3a 20 20 49 66 20 79 6f  nstraint:  If yo
6f90: 75 20 68 61 76 65 20 45 4e 41 42 4c 45 5f 43 4f  u have ENABLE_CO
6fa0: 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 20 74 68  LUMN_METADATA th
6fb0: 65 6e 20 79 6f 75 20 6d 75 73 74 0a 2a 2a 20 6e  en you must.** n
6fc0: 6f 74 20 64 65 66 69 6e 65 20 4f 4d 49 54 5f 44  ot define OMIT_D
6fd0: 45 43 4c 54 59 50 45 2e 0a 2a 2f 0a 23 69 66 20  ECLTYPE..*/.#if 
6fe0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f  defined(SQLITE_O
6ff0: 4d 49 54 5f 44 45 43 4c 54 59 50 45 29 20 26 26  MIT_DECLTYPE) &&
7000: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f   defined(SQLITE_
7010: 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45  ENABLE_COLUMN_ME
7020: 54 41 44 41 54 41 29 0a 23 20 65 72 72 6f 72 20  TADATA).# error 
7030: 22 4d 75 73 74 20 6e 6f 74 20 64 65 66 69 6e 65  "Must not define
7040: 20 62 6f 74 68 20 53 51 4c 49 54 45 5f 4f 4d 49   both SQLITE_OMI
7050: 54 5f 44 45 43 4c 54 59 50 45 20 5c 0a 20 20 20  T_DECLTYPE \.   
7060: 20 20 20 20 20 20 61 6e 64 20 53 51 4c 49 54 45        and SQLITE
7070: 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d  _ENABLE_COLUMN_M
7080: 45 54 41 44 41 54 41 22 0a 23 65 6e 64 69 66 0a  ETADATA".#endif.
7090: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
70a0: 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45 0a 2f 2a  OMIT_DECLTYPE./*
70b0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63  .** Return the c
70c0: 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f  olumn declaratio
70d0: 6e 20 74 79 70 65 20 28 69 66 20 61 70 70 6c 69  n type (if appli
70e0: 63 61 62 6c 65 29 20 6f 66 20 74 68 65 20 27 69  cable) of the 'i
70f0: 27 74 68 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66  'th column.** of
7100: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20   the result set 
7110: 6f 66 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  of SQL statement
7120: 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74   pStmt..*/.const
7130: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63   char *sqlite3_c
7140: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 73  olumn_decltype(s
7150: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
7160: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  mt, int N){.  re
7170: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28  turn columnName(
7180: 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c  .      pStmt, N,
7190: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29   (const void*(*)
71a0: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76  (Mem*))sqlite3_v
71b0: 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41  alue_text, COLNA
71c0: 4d 45 5f 44 45 43 4c 54 59 50 45 29 3b 0a 7d 0a  ME_DECLTYPE);.}.
71d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
71e0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
71f0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
7200: 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28  lumn_decltype16(
7210: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
7220: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
7230: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
7240: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e  (.      pStmt, N
7250: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
7260: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
7270: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 43 4f  value_text16, CO
7280: 4c 4e 41 4d 45 5f 44 45 43 4c 54 59 50 45 29 3b  LNAME_DECLTYPE);
7290: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
72a0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
72b0: 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  /.#endif /* SQLI
72c0: 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45  TE_OMIT_DECLTYPE
72d0: 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49   */..#ifdef SQLI
72e0: 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e  TE_ENABLE_COLUMN
72f0: 5f 4d 45 54 41 44 41 54 41 0a 2f 2a 0a 2a 2a 20  _METADATA./*.** 
7300: 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20  Return the name 
7310: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  of the database 
7320: 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72 65 73  from which a res
7330: 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76  ult column deriv
7340: 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72  es..** NULL is r
7350: 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 72  eturned if the r
7360: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20  esult column is 
7370: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 72  an expression or
7380: 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20   constant or.** 
7390: 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 77 68  anything else wh
73a0: 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e  ich is not an un
73b0: 61 62 69 67 75 6f 75 73 20 72 65 66 65 72 65 6e  abiguous referen
73c0: 63 65 20 74 6f 20 61 20 64 61 74 61 62 61 73 65  ce to a database
73d0: 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73   column..*/.cons
73e0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  t char *sqlite3_
73f0: 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f  column_database_
7400: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
7410: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
7420: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
7430: 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74  nName(.      pSt
7440: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
7450: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
7460: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c  ite3_value_text,
7470: 20 43 4f 4c 4e 41 4d 45 5f 44 41 54 41 42 41 53   COLNAME_DATABAS
7480: 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  E);.}.#ifndef SQ
7490: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
74a0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
74b0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62  te3_column_datab
74c0: 61 73 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74  ase_name16(sqlit
74d0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
74e0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
74f0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20   columnName(.   
7500: 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f     pStmt, N, (co
7510: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
7520: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
7530: 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45  _text16, COLNAME
7540: 5f 44 41 54 41 42 41 53 45 29 3b 0a 7d 0a 23 65  _DATABASE);.}.#e
7550: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
7560: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a  MIT_UTF16 */../*
7570: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
7580: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65  ame of the table
7590: 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72 65   from which a re
75a0: 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69  sult column deri
75b0: 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20  ves..** NULL is 
75c0: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20  returned if the 
75d0: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73  result column is
75e0: 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f   an expression o
75f0: 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a  r constant or.**
7600: 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 77   anything else w
7610: 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20 75  hich is not an u
7620: 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65 72 65  nabiguous refere
7630: 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61 73  nce to a databas
7640: 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e  e column..*/.con
7650: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
7660: 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61  _column_table_na
7670: 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  me(sqlite3_stmt 
7680: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
7690: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
76a0: 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74  ame(.      pStmt
76b0: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64  , N, (const void
76c0: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74  *(*)(Mem*))sqlit
76d0: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20 43  e3_value_text, C
76e0: 4f 4c 4e 41 4d 45 5f 54 41 42 4c 45 29 3b 0a 7d  OLNAME_TABLE);.}
76f0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
7700: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
7710: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
7720: 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65  olumn_table_name
7730: 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  16(sqlite3_stmt 
7740: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
7750: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
7760: 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74  ame(.      pStmt
7770: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64  , N, (const void
7780: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74  *(*)(Mem*))sqlit
7790: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c  e3_value_text16,
77a0: 20 43 4f 4c 4e 41 4d 45 5f 54 41 42 4c 45 29 3b   COLNAME_TABLE);
77b0: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
77c0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
77d0: 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  /../*.** Return 
77e0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
77f0: 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 66 72 6f  table column fro
7800: 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74  m which a result
7810: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e   column derives.
7820: 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75  .** NULL is retu
7830: 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75  rned if the resu
7840: 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20  lt column is an 
7850: 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f  expression or co
7860: 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79  nstant or.** any
7870: 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68  thing else which
7880: 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69   is not an unabi
7890: 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20  guous reference 
78a0: 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 6f  to a database co
78b0: 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  lumn..*/.const c
78c0: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  har *sqlite3_col
78d0: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 28  umn_origin_name(
78e0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
78f0: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
7900: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
7910: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e  (.      pStmt, N
7920: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
7930: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
7940: 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e  value_text, COLN
7950: 41 4d 45 5f 43 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23  AME_COLUMN);.}.#
7960: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
7970: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76  IT_UTF16.const v
7980: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  oid *sqlite3_col
7990: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31  umn_origin_name1
79a0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
79b0: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
79c0: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
79d0: 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c  me(.      pStmt,
79e0: 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a   N, (const void*
79f0: 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65  (*)(Mem*))sqlite
7a00: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20  3_value_text16, 
7a10: 43 4f 4c 4e 41 4d 45 5f 43 4f 4c 55 4d 4e 29 3b  COLNAME_COLUMN);
7a20: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
7a30: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
7a40: 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  /.#endif /* SQLI
7a50: 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e  TE_ENABLE_COLUMN
7a60: 5f 4d 45 54 41 44 41 54 41 20 2a 2f 0a 0a 0a 2f  _METADATA */.../
7a70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
7a80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20  *************** 
7a90: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20 2a  sqlite3_bind_  *
7aa0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
7ab0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a 2a  **********.** .*
7ac0: 2a 20 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20  * Routines used 
7ad0: 74 6f 20 61 74 74 61 63 68 20 76 61 6c 75 65 73  to attach values
7ae0: 20 74 6f 20 77 69 6c 64 63 61 72 64 73 20 69 6e   to wildcards in
7af0: 20 61 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20   a compiled SQL 
7b00: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f 2a  statement..*/./*
7b10: 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68 65 20 76  .** Unbind the v
7b20: 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f 20 76 61  alue bound to va
7b30: 72 69 61 62 6c 65 20 69 20 69 6e 20 76 69 72 74  riable i in virt
7b40: 75 61 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20 54  ual machine p. T
7b50: 68 69 73 20 69 73 20 74 68 65 20 0a 2a 2a 20 74  his is the .** t
7b60: 68 65 20 73 61 6d 65 20 61 73 20 62 69 6e 64 69  he same as bindi
7b70: 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 20  ng a NULL value 
7b80: 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20 49  to the column. I
7b90: 66 20 74 68 65 20 22 69 22 20 70 61 72 61 6d 65  f the "i" parame
7ba0: 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f 66  ter is.** out of
7bb0: 20 72 61 6e 67 65 2c 20 74 68 65 6e 20 53 51 4c   range, then SQL
7bc0: 49 54 45 5f 52 41 4e 47 45 20 69 73 20 72 65 74  ITE_RANGE is ret
7bd0: 75 72 6e 65 64 2e 20 4f 74 68 65 77 69 73 65 20  urned. Othewise 
7be0: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a  SQLITE_OK..**.**
7bf0: 20 41 20 73 75 63 63 65 73 73 66 75 6c 20 65 76   A successful ev
7c00: 61 6c 75 61 74 69 6f 6e 20 6f 66 20 74 68 69 73  aluation of this
7c10: 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69 72 65   routine acquire
7c20: 73 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 70  s the mutex on p
7c30: 2e 0a 2a 2a 20 74 68 65 20 6d 75 74 65 78 20 69  ..** the mutex i
7c40: 73 20 72 65 6c 65 61 73 65 64 20 69 66 20 61 6e  s released if an
7c50: 79 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20  y kind of error 
7c60: 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68  occurs..**.** Th
7c70: 65 20 65 72 72 6f 72 20 63 6f 64 65 20 73 74 6f  e error code sto
7c80: 72 65 64 20 69 6e 20 64 61 74 61 62 61 73 65 20  red in database 
7c90: 70 2d 3e 64 62 20 69 73 20 6f 76 65 72 77 72 69  p->db is overwri
7ca0: 74 74 65 6e 20 77 69 74 68 20 74 68 65 20 72 65  tten with the re
7cb0: 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69 6e  turn.** value in
7cc0: 20 61 6e 79 20 63 61 73 65 2e 0a 2a 2f 0a 73 74   any case..*/.st
7cd0: 61 74 69 63 20 69 6e 74 20 76 64 62 65 55 6e 62  atic int vdbeUnb
7ce0: 69 6e 64 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  ind(Vdbe *p, int
7cf0: 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70 56 61 72   i){.  Mem *pVar
7d00: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72  ;.  if( p==0 ) r
7d10: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
7d20: 55 53 45 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d  USE;.  sqlite3_m
7d30: 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62  utex_enter(p->db
7d40: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20  ->mutex);.  if( 
7d50: 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  p->magic!=VDBE_M
7d60: 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70  AGIC_RUN || p->p
7d70: 63 3e 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69  c>=0 ){.    sqli
7d80: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
7d90: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30  SQLITE_MISUSE, 0
7da0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
7db0: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62  utex_leave(p->db
7dc0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65  ->mutex);.    re
7dd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  turn SQLITE_MISU
7de0: 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 3c  SE;.  }.  if( i<
7df0: 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29  1 || i>p->nVar )
7e00: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72  {.    sqlite3Err
7e10: 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45  or(p->db, SQLITE
7e20: 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20  _RANGE, 0);.    
7e30: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
7e40: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ave(p->db->mutex
7e50: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
7e60: 4c 49 54 45 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a  LITE_RANGE;.  }.
7e70: 20 20 69 2d 2d 3b 0a 20 20 70 56 61 72 20 3d 20    i--;.  pVar = 
7e80: 26 70 2d 3e 61 56 61 72 5b 69 5d 3b 0a 20 20 73  &p->aVar[i];.  s
7e90: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
7ea0: 65 61 73 65 28 70 56 61 72 29 3b 0a 20 20 70 56  ease(pVar);.  pV
7eb0: 61 72 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  ar->flags = MEM_
7ec0: 4e 75 6c 6c 3b 0a 20 20 73 71 6c 69 74 65 33 45  Null;.  sqlite3E
7ed0: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49  rror(p->db, SQLI
7ee0: 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 72 65 74  TE_OK, 0);.  ret
7ef0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
7f00: 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 74  ../*.** Bind a t
7f10: 65 78 74 20 6f 72 20 42 4c 4f 42 20 76 61 6c 75  ext or BLOB valu
7f20: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
7f30: 20 62 69 6e 64 54 65 78 74 28 0a 20 20 73 71 6c   bindText(.  sql
7f40: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
7f50: 2c 20 20 20 2f 2a 20 54 68 65 20 73 74 61 74 65  ,   /* The state
7f60: 6d 65 6e 74 20 74 6f 20 62 69 6e 64 20 61 67 61  ment to bind aga
7f70: 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74 20 69 2c  inst */.  int i,
7f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7f90: 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 74 68 65   /* Index of the
7fa0: 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 62 69   parameter to bi
7fb0: 6e 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f  nd */.  const vo
7fc0: 69 64 20 2a 7a 44 61 74 61 2c 20 20 20 20 20 2f  id *zData,     /
7fd0: 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  * Pointer to the
7fe0: 20 64 61 74 61 20 74 6f 20 62 65 20 62 6f 75 6e   data to be boun
7ff0: 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 44 61 74 61  d */.  int nData
8000: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ,             /*
8010: 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   Number of bytes
8020: 20 6f 66 20 64 61 74 61 20 74 6f 20 62 65 20 62   of data to be b
8030: 6f 75 6e 64 20 2a 2f 0a 20 20 76 6f 69 64 20 28  ound */.  void (
8040: 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 2c 20 20  *xDel)(void*),  
8050: 20 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 20 66   /* Destructor f
8060: 6f 72 20 74 68 65 20 64 61 74 61 20 2a 2f 0a 20  or the data */. 
8070: 20 75 38 20 65 6e 63 6f 64 69 6e 67 20 20 20 20   u8 encoding    
8080: 20 20 20 20 20 20 20 20 2f 2a 20 45 6e 63 6f 64          /* Encod
8090: 69 6e 67 20 66 6f 72 20 74 68 65 20 64 61 74 61  ing for the data
80a0: 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70   */.){.  Vdbe *p
80b0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
80c0: 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20  ;.  Mem *pVar;. 
80d0: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d   int rc;..  rc =
80e0: 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69   vdbeUnbind(p, i
80f0: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  );.  if( rc==SQL
8100: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66  ITE_OK ){.    if
8110: 28 20 7a 44 61 74 61 21 3d 30 20 29 7b 0a 20 20  ( zData!=0 ){.  
8120: 20 20 20 20 70 56 61 72 20 3d 20 26 70 2d 3e 61      pVar = &p->a
8130: 56 61 72 5b 69 2d 31 5d 3b 0a 20 20 20 20 20 20  Var[i-1];.      
8140: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
8150: 4d 65 6d 53 65 74 53 74 72 28 70 56 61 72 2c 20  MemSetStr(pVar, 
8160: 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 65 6e  zData, nData, en
8170: 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29 3b 0a 20  coding, xDel);. 
8180: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
8190: 49 54 45 5f 4f 4b 20 26 26 20 65 6e 63 6f 64 69  ITE_OK && encodi
81a0: 6e 67 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  ng!=0 ){.       
81b0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
81c0: 65 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28  eChangeEncoding(
81d0: 70 56 61 72 2c 20 45 4e 43 28 70 2d 3e 64 62 29  pVar, ENC(p->db)
81e0: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  );.      }.     
81f0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
8200: 3e 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 20  >db, rc, 0);.   
8210: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41     rc = sqlite3A
8220: 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 72 63  piExit(p->db, rc
8230: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
8240: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
8250: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
8260: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
8270: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20  .}.../*.** Bind 
8280: 61 20 62 6c 6f 62 20 76 61 6c 75 65 20 74 6f 20  a blob value to 
8290: 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  an SQL statement
82a0: 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 69 6e   variable..*/.in
82b0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 62  t sqlite3_bind_b
82c0: 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  lob(.  sqlite3_s
82d0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69  tmt *pStmt, .  i
82e0: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76  nt i, .  const v
82f0: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69  oid *zData, .  i
8300: 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69  nt nData, .  voi
8310: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29  d (*xDel)(void*)
8320: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 6e  .){.  return bin
8330: 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20  dText(pStmt, i, 
8340: 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 44  zData, nData, xD
8350: 65 6c 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20 73 71  el, 0);.}.int sq
8360: 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c  lite3_bind_doubl
8370: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
8380: 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 64 6f  pStmt, int i, do
8390: 75 62 6c 65 20 72 56 61 6c 75 65 29 7b 0a 20 20  uble rValue){.  
83a0: 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a  int rc;.  Vdbe *
83b0: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
83c0: 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  t;.  rc = vdbeUn
83d0: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
83e0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
83f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
8400: 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65 28 26  beMemSetDouble(&
8410: 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 72 56  p->aVar[i-1], rV
8420: 61 6c 75 65 29 3b 0a 20 20 20 20 73 71 6c 69 74  alue);.    sqlit
8430: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
8440: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  ->db->mutex);.  
8450: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
8460: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
8470: 64 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73 74  d_int(sqlite3_st
8480: 6d 74 20 2a 70 2c 20 69 6e 74 20 69 2c 20 69 6e  mt *p, int i, in
8490: 74 20 69 56 61 6c 75 65 29 7b 0a 20 20 72 65 74  t iValue){.  ret
84a0: 75 72 6e 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  urn sqlite3_bind
84b0: 5f 69 6e 74 36 34 28 70 2c 20 69 2c 20 28 69 36  _int64(p, i, (i6
84c0: 34 29 69 56 61 6c 75 65 29 3b 0a 7d 0a 69 6e 74  4)iValue);.}.int
84d0: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e   sqlite3_bind_in
84e0: 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  t64(sqlite3_stmt
84f0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20   *pStmt, int i, 
8500: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69 56 61  sqlite_int64 iVa
8510: 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  lue){.  int rc;.
8520: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
8530: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20  e *)pStmt;.  rc 
8540: 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20  = vdbeUnbind(p, 
8550: 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  i);.  if( rc==SQ
8560: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73  LITE_OK ){.    s
8570: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
8580: 49 6e 74 36 34 28 26 70 2d 3e 61 56 61 72 5b 69  Int64(&p->aVar[i
8590: 2d 31 5d 2c 20 69 56 61 6c 75 65 29 3b 0a 20 20  -1], iValue);.  
85a0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
85b0: 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74  leave(p->db->mut
85c0: 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  ex);.  }.  retur
85d0: 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  n rc;.}.int sqli
85e0: 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71  te3_bind_null(sq
85f0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
8600: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74  t, int i){.  int
8610: 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d   rc;.  Vdbe *p =
8620: 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20   (Vdbe*)pStmt;. 
8630: 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64   rc = vdbeUnbind
8640: 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63  (p, i);.  if( rc
8650: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
8660: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
8670: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75  _leave(p->db->mu
8680: 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  tex);.  }.  retu
8690: 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c  rn rc;.}.int sql
86a0: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28 20  ite3_bind_text( 
86b0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
86c0: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69  *pStmt, .  int i
86d0: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  , .  const char 
86e0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e  *zData, .  int n
86f0: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a  Data, .  void (*
8700: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a  xDel)(void*).){.
8710: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78    return bindTex
8720: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74  t(pStmt, i, zDat
8730: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20  a, nData, xDel, 
8740: 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a  SQLITE_UTF8);.}.
8750: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
8760: 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71  MIT_UTF16.int sq
8770: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31  lite3_bind_text1
8780: 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  6(.  sqlite3_stm
8790: 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74  t *pStmt, .  int
87a0: 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69   i, .  const voi
87b0: 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74  d *zData, .  int
87c0: 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20   nData, .  void 
87d0: 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29  (*xDel)(void*).)
87e0: 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54  {.  return bindT
87f0: 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44  ext(pStmt, i, zD
8800: 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c  ata, nData, xDel
8810: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41  , SQLITE_UTF16NA
8820: 54 49 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20  TIVE);.}.#endif 
8830: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
8840: 54 46 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69  TF16 */.int sqli
8850: 74 65 33 5f 62 69 6e 64 5f 76 61 6c 75 65 28 73  te3_bind_value(s
8860: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
8870: 6d 74 2c 20 69 6e 74 20 69 2c 20 63 6f 6e 73 74  mt, int i, const
8880: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
8890: 70 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72  pValue){.  int r
88a0: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  c;.  Vdbe *p = (
88b0: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20  Vdbe *)pStmt;.  
88c0: 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28  rc = vdbeUnbind(
88d0: 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d  p, i);.  if( rc=
88e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
88f0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64    rc = sqlite3Vd
8900: 62 65 4d 65 6d 43 6f 70 79 28 26 70 2d 3e 61 56  beMemCopy(&p->aV
8910: 61 72 5b 69 2d 31 5d 2c 20 70 56 61 6c 75 65 29  ar[i-1], pValue)
8920: 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51  ;.    if( rc==SQ
8930: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
8940: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
8950: 65 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28  eChangeEncoding(
8960: 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 45  &p->aVar[i-1], E
8970: 4e 43 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20  NC(p->db));.    
8980: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  }.    sqlite3_mu
8990: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d  tex_leave(p->db-
89a0: 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 63 20  >mutex);.    rc 
89b0: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  = sqlite3ApiExit
89c0: 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 7d  (p->db, rc);.  }
89d0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
89e0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
89f0: 5f 7a 65 72 6f 62 6c 6f 62 28 73 71 6c 69 74 65  _zeroblob(sqlite
8a00: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
8a10: 6e 74 20 69 2c 20 69 6e 74 20 6e 29 7b 0a 20 20  nt i, int n){.  
8a20: 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a  int rc;.  Vdbe *
8a30: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
8a40: 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  t;.  rc = vdbeUn
8a50: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
8a60: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
8a70: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
8a80: 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62  beMemSetZeroBlob
8a90: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
8aa0: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  n);.    sqlite3_
8ab0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64  mutex_leave(p->d
8ac0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20  b->mutex);.  }. 
8ad0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
8ae0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
8af0: 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c 64 63 61  number of wildca
8b00: 72 64 73 20 74 68 61 74 20 63 61 6e 20 62 65 20  rds that can be 
8b10: 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62 6f 75 6e  potentially boun
8b20: 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73 20 72 6f  d to..** This ro
8b30: 75 74 69 6e 65 20 69 73 20 61 64 64 65 64 20 74  utine is added t
8b40: 6f 20 73 75 70 70 6f 72 74 20 44 42 44 3a 3a 53  o support DBD::S
8b50: 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69 6e 74 20  QLite.  .*/.int 
8b60: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72  sqlite3_bind_par
8b70: 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28 73 71 6c  ameter_count(sql
8b80: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
8b90: 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  ){.  Vdbe *p = (
8ba0: 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 72  Vdbe*)pStmt;.  r
8bb0: 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e 6e 56 61  eturn p ? p->nVa
8bc0: 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  r : 0;.}../*.** 
8bd0: 43 72 65 61 74 65 20 61 20 6d 61 70 70 69 6e 67  Create a mapping
8be0: 20 66 72 6f 6d 20 76 61 72 69 61 62 6c 65 20 6e   from variable n
8bf0: 75 6d 62 65 72 73 20 74 6f 20 76 61 72 69 61 62  umbers to variab
8c00: 6c 65 20 6e 61 6d 65 73 0a 2a 2a 20 69 6e 20 74  le names.** in t
8c10: 68 65 20 56 64 62 65 2e 61 7a 56 61 72 5b 5d 20  he Vdbe.azVar[] 
8c20: 61 72 72 61 79 2c 20 69 66 20 73 75 63 68 20 61  array, if such a
8c30: 20 6d 61 70 70 69 6e 67 20 64 6f 65 73 20 6e 6f   mapping does no
8c40: 74 20 61 6c 72 65 61 64 79 0a 2a 2a 20 65 78 69  t already.** exi
8c50: 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  st..*/.static vo
8c60: 69 64 20 63 72 65 61 74 65 56 61 72 4d 61 70 28  id createVarMap(
8c70: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20  Vdbe *p){.  if( 
8c80: 21 70 2d 3e 6f 6b 56 61 72 20 29 7b 0a 20 20 20  !p->okVar ){.   
8c90: 20 69 6e 74 20 6a 3b 0a 20 20 20 20 4f 70 20 2a   int j;.    Op *
8ca0: 70 4f 70 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  pOp;.    sqlite3
8cb0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e  _mutex_enter(p->
8cc0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20  db->mutex);.    
8cd0: 2f 2a 20 54 68 65 20 72 61 63 65 20 63 6f 6e 64  /* The race cond
8ce0: 69 74 69 6f 6e 20 68 65 72 65 20 69 73 20 68 61  ition here is ha
8cf0: 72 6d 6c 65 73 73 2e 20 20 49 66 20 74 77 6f 20  rmless.  If two 
8d00: 74 68 72 65 61 64 73 20 63 61 6c 6c 20 74 68 69  threads call thi
8d10: 73 0a 20 20 20 20 2a 2a 20 72 6f 75 74 69 6e 65  s.    ** routine
8d20: 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 56 64 62   on the same Vdb
8d30: 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69  e at the same ti
8d40: 6d 65 2c 20 74 68 65 79 20 62 6f 74 68 20 6d 69  me, they both mi
8d50: 67 68 74 20 65 6e 64 0a 20 20 20 20 2a 2a 20 75  ght end.    ** u
8d60: 70 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74  p initializing t
8d70: 68 65 20 56 64 62 65 2e 61 7a 56 61 72 5b 5d 20  he Vdbe.azVar[] 
8d80: 61 72 72 61 79 2e 20 20 54 68 61 74 20 69 73 20  array.  That is 
8d90: 61 20 6c 69 74 74 6c 65 20 65 78 74 72 61 0a 20  a little extra. 
8da0: 20 20 20 2a 2a 20 77 6f 72 6b 20 62 75 74 20 69     ** work but i
8db0: 74 20 72 65 73 75 6c 74 73 20 69 6e 20 74 68 65  t results in the
8dc0: 20 73 61 6d 65 20 61 6e 73 77 65 72 2e 0a 20 20   same answer..  
8dd0: 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 6a 3d 30    */.    for(j=0
8de0: 2c 20 70 4f 70 3d 70 2d 3e 61 4f 70 3b 20 6a 3c  , pOp=p->aOp; j<
8df0: 70 2d 3e 6e 4f 70 3b 20 6a 2b 2b 2c 20 70 4f 70  p->nOp; j++, pOp
8e00: 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  ++){.      if( p
8e10: 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 56  Op->opcode==OP_V
8e20: 61 72 69 61 62 6c 65 20 29 7b 0a 20 20 20 20 20  ariable ){.     
8e30: 20 20 20 61 73 73 65 72 74 28 20 70 4f 70 2d 3e     assert( pOp->
8e40: 70 31 3e 30 20 26 26 20 70 4f 70 2d 3e 70 31 3c  p1>0 && pOp->p1<
8e50: 3d 70 2d 3e 6e 56 61 72 20 29 3b 0a 20 20 20 20  =p->nVar );.    
8e60: 20 20 20 20 70 2d 3e 61 7a 56 61 72 5b 70 4f 70      p->azVar[pOp
8e70: 2d 3e 70 31 2d 31 5d 20 3d 20 70 4f 70 2d 3e 70  ->p1-1] = pOp->p
8e80: 34 2e 7a 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  4.z;.      }.   
8e90: 20 7d 0a 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20   }.    p->okVar 
8ea0: 3d 20 31 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  = 1;.    sqlite3
8eb0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e  _mutex_leave(p->
8ec0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a  db->mutex);.  }.
8ed0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
8ee0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 77 69  the name of a wi
8ef0: 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74 65 72  ldcard parameter
8f00: 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69  .  Return NULL i
8f10: 66 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 69  f the index.** i
8f20: 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 20 6f  s out of range o
8f30: 72 20 69 66 20 74 68 65 20 77 69 6c 64 63 61 72  r if the wildcar
8f40: 64 20 69 73 20 75 6e 6e 61 6d 65 64 2e 0a 2a 2a  d is unnamed..**
8f50: 0a 2a 2a 20 54 68 65 20 72 65 73 75 6c 74 20 69  .** The result i
8f60: 73 20 61 6c 77 61 79 73 20 55 54 46 2d 38 2e 0a  s always UTF-8..
8f70: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
8f80: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 61  qlite3_bind_para
8f90: 6d 65 74 65 72 5f 6e 61 6d 65 28 73 71 6c 69 74  meter_name(sqlit
8fa0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
8fb0: 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20 2a  int i){.  Vdbe *
8fc0: 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74  p = (Vdbe*)pStmt
8fd0: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20  ;.  if( p==0 || 
8fe0: 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72  i<1 || i>p->nVar
8ff0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
9000: 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65 56 61  ;.  }.  createVa
9010: 72 4d 61 70 28 70 29 3b 0a 20 20 72 65 74 75 72  rMap(p);.  retur
9020: 6e 20 70 2d 3e 61 7a 56 61 72 5b 69 2d 31 5d 3b  n p->azVar[i-1];
9030: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20  .}../*.** Given 
9040: 61 20 77 69 6c 64 63 61 72 64 20 70 61 72 61 6d  a wildcard param
9050: 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74 75 72  eter name, retur
9060: 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74  n the index of t
9070: 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 77  he variable.** w
9080: 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e 20 20  ith that name.  
9090: 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 76  If there is no v
90a0: 61 72 69 61 62 6c 65 20 77 69 74 68 20 74 68 65  ariable with the
90b0: 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a 20   given name,.** 
90c0: 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74  return 0..*/.int
90d0: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61   sqlite3_bind_pa
90e0: 72 61 6d 65 74 65 72 5f 69 6e 64 65 78 28 73 71  rameter_index(sq
90f0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
9100: 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  t, const char *z
9110: 4e 61 6d 65 29 7b 0a 20 20 56 64 62 65 20 2a 70  Name){.  Vdbe *p
9120: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b   = (Vdbe*)pStmt;
9130: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 20  .  int i;.  if( 
9140: 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  p==0 ){.    retu
9150: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 63 72 65 61  rn 0;.  }.  crea
9160: 74 65 56 61 72 4d 61 70 28 70 29 3b 20 0a 20 20  teVarMap(p); .  
9170: 69 66 28 20 7a 4e 61 6d 65 20 29 7b 0a 20 20 20  if( zName ){.   
9180: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e   for(i=0; i<p->n
9190: 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  Var; i++){.     
91a0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d   const char *z =
91b0: 20 70 2d 3e 61 7a 56 61 72 5b 69 5d 3b 0a 20 20   p->azVar[i];.  
91c0: 20 20 20 20 69 66 28 20 7a 20 26 26 20 73 74 72      if( z && str
91d0: 63 6d 70 28 7a 2c 7a 4e 61 6d 65 29 3d 3d 30 20  cmp(z,zName)==0 
91e0: 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72  ){.        retur
91f0: 6e 20 69 2b 31 3b 0a 20 20 20 20 20 20 7d 0a 20  n i+1;.      }. 
9200: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
9210: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72  n 0;.}../*.** Tr
9220: 61 6e 73 66 65 72 20 61 6c 6c 20 62 69 6e 64 69  ansfer all bindi
9230: 6e 67 73 20 66 72 6f 6d 20 74 68 65 20 66 69 72  ngs from the fir
9240: 73 74 20 73 74 61 74 65 6d 65 6e 74 20 6f 76 65  st statement ove
9250: 72 20 74 6f 20 74 68 65 20 73 65 63 6f 6e 64 2e  r to the second.
9260: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 54  .*/.int sqlite3T
9270: 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73 28  ransferBindings(
9280: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 46  sqlite3_stmt *pF
9290: 72 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65 33  romStmt, sqlite3
92a0: 5f 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29 7b  _stmt *pToStmt){
92b0: 0a 20 20 56 64 62 65 20 2a 70 46 72 6f 6d 20 3d  .  Vdbe *pFrom =
92c0: 20 28 56 64 62 65 2a 29 70 46 72 6f 6d 53 74 6d   (Vdbe*)pFromStm
92d0: 74 3b 0a 20 20 56 64 62 65 20 2a 70 54 6f 20 3d  t;.  Vdbe *pTo =
92e0: 20 28 56 64 62 65 2a 29 70 54 6f 53 74 6d 74 3b   (Vdbe*)pToStmt;
92f0: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61 73 73 65  .  int i;.  asse
9300: 72 74 28 20 70 54 6f 2d 3e 64 62 3d 3d 70 46 72  rt( pTo->db==pFr
9310: 6f 6d 2d 3e 64 62 20 29 3b 0a 20 20 61 73 73 65  om->db );.  asse
9320: 72 74 28 20 70 54 6f 2d 3e 6e 56 61 72 3d 3d 70  rt( pTo->nVar==p
9330: 46 72 6f 6d 2d 3e 6e 56 61 72 20 29 3b 0a 20 20  From->nVar );.  
9340: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
9350: 74 65 72 28 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74  ter(pTo->db->mut
9360: 65 78 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  ex);.  for(i=0; 
9370: 69 3c 70 46 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69  i<pFrom->nVar; i
9380: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
9390: 56 64 62 65 4d 65 6d 4d 6f 76 65 28 26 70 54 6f  VdbeMemMove(&pTo
93a0: 2d 3e 61 56 61 72 5b 69 5d 2c 20 26 70 46 72 6f  ->aVar[i], &pFro
93b0: 6d 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 20 7d  m->aVar[i]);.  }
93c0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
93d0: 5f 6c 65 61 76 65 28 70 54 6f 2d 3e 64 62 2d 3e  _leave(pTo->db->
93e0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e  mutex);.  return
93f0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23   SQLITE_OK;.}..#
9400: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
9410: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a  IT_DEPRECATED./*
9420: 0a 2a 2a 20 44 65 70 72 65 63 61 74 65 64 20 65  .** Deprecated e
9430: 78 74 65 72 6e 61 6c 20 69 6e 74 65 72 66 61 63  xternal interfac
9440: 65 2e 20 20 49 6e 74 65 72 6e 61 6c 2f 63 6f 72  e.  Internal/cor
9450: 65 20 53 51 4c 69 74 65 20 63 6f 64 65 0a 2a 2a  e SQLite code.**
9460: 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 73 71 6c   should call sql
9470: 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e 64  ite3TransferBind
9480: 69 6e 67 73 2e 0a 2a 2a 0a 2a 2a 20 49 73 20 69  ings..**.** Is i
9490: 73 20 6d 69 73 75 73 65 20 74 6f 20 63 61 6c 6c  s misuse to call
94a0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69   this routine wi
94b0: 74 68 20 73 74 61 74 65 6d 65 6e 74 73 20 66 72  th statements fr
94c0: 6f 6d 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20  om different.** 
94d0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
94e0: 69 6f 6e 73 2e 20 20 42 75 74 20 61 73 20 74 68  ions.  But as th
94f0: 69 73 20 69 73 20 61 20 64 65 70 72 65 63 61 74  is is a deprecat
9500: 65 64 20 69 6e 74 65 72 66 61 63 65 2c 20 77 65  ed interface, we
9510: 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 62 6f 74  .** will not bot
9520: 68 65 72 20 74 6f 20 63 68 65 63 6b 20 66 6f 72  her to check for
9530: 20 74 68 61 74 20 63 6f 6e 64 69 74 69 6f 6e 2e   that condition.
9540: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 74 77  .**.** If the tw
9550: 6f 20 73 74 61 74 65 6d 65 6e 74 73 20 63 6f 6e  o statements con
9560: 74 61 69 6e 20 61 20 64 69 66 66 65 72 65 6e 74  tain a different
9570: 20 6e 75 6d 62 65 72 20 6f 66 20 62 69 6e 64 69   number of bindi
9580: 6e 67 73 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 20  ngs, then.** an 
9590: 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 73 20  SQLITE_ERROR is 
95a0: 72 65 74 75 72 6e 65 64 2e 20 20 4e 6f 74 68 69  returned.  Nothi
95b0: 6e 67 20 65 6c 73 65 20 63 61 6e 20 67 6f 20 77  ng else can go w
95c0: 72 6f 6e 67 2c 20 73 6f 20 6f 74 68 65 72 77 69  rong, so otherwi
95d0: 73 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20  se.** SQLITE_OK 
95e0: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a  is returned..*/.
95f0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 72 61 6e  int sqlite3_tran
9600: 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28 73 71  sfer_bindings(sq
9610: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 46 72 6f  lite3_stmt *pFro
9620: 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65 33 5f 73  mStmt, sqlite3_s
9630: 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29 7b 0a 20  tmt *pToStmt){. 
9640: 20 56 64 62 65 20 2a 70 46 72 6f 6d 20 3d 20 28   Vdbe *pFrom = (
9650: 56 64 62 65 2a 29 70 46 72 6f 6d 53 74 6d 74 3b  Vdbe*)pFromStmt;
9660: 0a 20 20 56 64 62 65 20 2a 70 54 6f 20 3d 20 28  .  Vdbe *pTo = (
9670: 56 64 62 65 2a 29 70 54 6f 53 74 6d 74 3b 0a 20  Vdbe*)pToStmt;. 
9680: 20 69 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61 72   if( pFrom->nVar
9690: 21 3d 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20  !=pTo->nVar ){. 
96a0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
96b0: 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 72 65  _ERROR;.  }.  re
96c0: 74 75 72 6e 20 73 71 6c 69 74 65 33 54 72 61 6e  turn sqlite3Tran
96d0: 73 66 65 72 42 69 6e 64 69 6e 67 73 28 70 46 72  sferBindings(pFr
96e0: 6f 6d 53 74 6d 74 2c 20 70 54 6f 53 74 6d 74 29  omStmt, pToStmt)
96f0: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  ;.}.#endif../*.*
9700: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 71 6c  * Return the sql
9710: 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20 68  ite3* database h
9720: 61 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74  andle to which t
9730: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
9740: 65 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 69  ement given.** i
9750: 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 62  n the argument b
9760: 65 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 73  elongs.  This is
9770: 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61   the same databa
9780: 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 77  se handle that w
9790: 61 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20  as.** the first 
97a0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20  argument to the 
97b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28  sqlite3_prepare(
97c0: 29 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20  ) that was used 
97d0: 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 65  to create.** the
97e0: 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68   statement in th
97f0: 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 2a  e first place..*
9800: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74  /.sqlite3 *sqlit
9810: 65 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c  e3_db_handle(sql
9820: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
9830: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d  ){.  return pStm
9840: 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d  t ? ((Vdbe*)pStm
9850: 74 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a 0a 2f  t)->db : 0;.}../
9860: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f  *.** Return a po
9870: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e 65 78  inter to the nex
9880: 74 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  t prepared state
9890: 6d 65 6e 74 20 61 66 74 65 72 20 70 53 74 6d 74  ment after pStmt
98a0: 20 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77   associated.** w
98b0: 69 74 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e  ith database con
98c0: 6e 65 63 74 69 6f 6e 20 70 44 62 2e 20 20 49 66  nection pDb.  If
98d0: 20 70 53 74 6d 74 20 69 73 20 4e 55 4c 4c 2c 20   pStmt is NULL, 
98e0: 72 65 74 75 72 6e 20 74 68 65 20 66 69 72 73 74  return the first
98f0: 0a 2a 2a 20 70 72 65 70 61 72 65 64 20 73 74 61  .** prepared sta
9900: 74 65 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 64  tement for the d
9910: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
9920: 6f 6e 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c  on.  Return NULL
9930: 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65   if there.** are
9940: 20 6e 6f 20 6d 6f 72 65 2e 0a 2a 2f 0a 73 71 6c   no more..*/.sql
9950: 69 74 65 33 5f 73 74 6d 74 20 2a 73 71 6c 69 74  ite3_stmt *sqlit
9960: 65 33 5f 6e 65 78 74 5f 73 74 6d 74 28 73 71 6c  e3_next_stmt(sql
9970: 69 74 65 33 20 2a 70 44 62 2c 20 73 71 6c 69 74  ite3 *pDb, sqlit
9980: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
9990: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
99a0: 2a 70 4e 65 78 74 3b 0a 20 20 73 71 6c 69 74 65  *pNext;.  sqlite
99b0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 44  3_mutex_enter(pD
99c0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28  b->mutex);.  if(
99d0: 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 20   pStmt==0 ){.   
99e0: 20 70 4e 65 78 74 20 3d 20 28 73 71 6c 69 74 65   pNext = (sqlite
99f0: 33 5f 73 74 6d 74 2a 29 70 44 62 2d 3e 70 56 64  3_stmt*)pDb->pVd
9a00: 62 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  be;.  }else{.   
9a10: 20 70 4e 65 78 74 20 3d 20 28 73 71 6c 69 74 65   pNext = (sqlite
9a20: 33 5f 73 74 6d 74 2a 29 28 28 56 64 62 65 2a 29  3_stmt*)((Vdbe*)
9a30: 70 53 74 6d 74 29 2d 3e 70 4e 65 78 74 3b 0a 20  pStmt)->pNext;. 
9a40: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74   }.  sqlite3_mut
9a50: 65 78 5f 6c 65 61 76 65 28 70 44 62 2d 3e 6d 75  ex_leave(pDb->mu
9a60: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  tex);.  return p
9a70: 4e 65 78 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  Next;.}../*.** R
9a80: 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20  eturn the value 
9a90: 6f 66 20 61 20 73 74 61 74 75 73 20 63 6f 75 6e  of a status coun
9aa0: 74 65 72 20 66 6f 72 20 61 20 70 72 65 70 61 72  ter for a prepar
9ab0: 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2f 0a  ed statement.*/.
9ac0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  int sqlite3_stmt
9ad0: 5f 73 74 61 74 75 73 28 73 71 6c 69 74 65 33 5f  _status(sqlite3_
9ae0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
9af0: 20 6f 70 2c 20 69 6e 74 20 72 65 73 65 74 46 6c   op, int resetFl
9b00: 61 67 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 64  ag){.  Vdbe *pVd
9b10: 62 65 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d  be = (Vdbe*)pStm
9b20: 74 3b 0a 20 20 69 6e 74 20 76 20 3d 20 70 56 64  t;.  int v = pVd
9b30: 62 65 2d 3e 61 43 6f 75 6e 74 65 72 5b 6f 70 2d  be->aCounter[op-
9b40: 31 5d 3b 0a 20 20 69 66 28 20 72 65 73 65 74 46  1];.  if( resetF
9b50: 6c 61 67 20 29 20 70 56 64 62 65 2d 3e 61 43 6f  lag ) pVdbe->aCo
9b60: 75 6e 74 65 72 5b 6f 70 2d 31 5d 20 3d 20 30 3b  unter[op-1] = 0;
9b70: 0a 20 20 72 65 74 75 72 6e 20 76 3b 0a 7d 0a     .  return v;.}.