/ Hex Artifact Content
Login

Artifact 20722164e7701a0747eaea03cddbbe0de5cb37bf:


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 34 39 20  beapi.c,v 1.149 
01e0: 32 30 30 38 2f 31 31 2f 31 39 20 30 39 3a 30 35  2008/11/19 09:05
01f0: 3a 32 37 20 64 61 6e 69 65 6c 6b 31 39 37 37 20  :27 danielk1977 
0200: 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64  Exp $.*/.#includ
0210: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
0220: 23 69 6e 63 6c 75 64 65 20 22 76 64 62 65 49 6e  #include "vdbeIn
0230: 74 2e 68 22 0a 0a 23 69 66 20 30 20 26 26 20 64  t.h"..#if 0 && d
0240: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e  efined(SQLITE_EN
0250: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
0260: 47 45 4d 45 4e 54 29 0a 2f 2a 0a 2a 2a 20 54 68  GEMENT)./*.** Th
0270: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  e following stru
0280: 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 70  cture contains p
0290: 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 65 20 65  ointers to the e
02a0: 6e 64 20 70 6f 69 6e 74 73 20 6f 66 20 61 0a 2a  nd points of a.*
02b0: 2a 20 64 6f 75 62 6c 79 2d 6c 69 6e 6b 65 64 20  * doubly-linked 
02c0: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 63 6f 6d 70  list of all comp
02d0: 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  iled SQL stateme
02e0: 6e 74 73 20 74 68 61 74 20 6d 61 79 20 62 65 20  nts that may be 
02f0: 68 6f 6c 64 69 6e 67 0a 2a 2a 20 62 75 66 66 65  holding.** buffe
0300: 72 73 20 65 6c 69 67 69 62 6c 65 20 66 6f 72 20  rs eligible for 
0310: 72 65 6c 65 61 73 65 20 77 68 65 6e 20 74 68 65  release when the
0320: 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65   sqlite3_release
0330: 5f 6d 65 6d 6f 72 79 28 29 20 69 6e 74 65 72 66  _memory() interf
0340: 61 63 65 20 69 73 0a 2a 2a 20 69 6e 76 6f 6b 65  ace is.** invoke
0350: 64 2e 20 41 63 63 65 73 73 20 74 6f 20 74 68 69  d. Access to thi
0360: 73 20 6c 69 73 74 20 69 73 20 70 72 6f 74 65 63  s list is protec
0370: 74 65 64 20 62 79 20 74 68 65 20 53 51 4c 49 54  ted by the SQLIT
0380: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
0390: 52 55 32 0a 2a 2a 20 6d 75 74 65 78 2e 0a 2a 2a  RU2.** mutex..**
03a0: 0a 2a 2a 20 53 74 61 74 65 6d 65 6e 74 73 20 61  .** Statements a
03b0: 72 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  re added to the 
03c0: 65 6e 64 20 6f 66 20 74 68 69 73 20 6c 69 73 74  end of this list
03d0: 20 77 68 65 6e 20 73 71 6c 69 74 65 33 5f 72 65   when sqlite3_re
03e0: 73 65 74 28 29 20 69 73 0a 2a 2a 20 63 61 6c 6c  set() is.** call
03f0: 65 64 2e 20 54 68 65 79 20 61 72 65 20 72 65 6d  ed. They are rem
0400: 6f 76 65 64 20 65 69 74 68 65 72 20 77 68 65 6e  oved either when
0410: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20   sqlite3_step() 
0420: 6f 72 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c  or sqlite3_final
0430: 69 7a 65 28 29 0a 2a 2a 20 69 73 20 63 61 6c 6c  ize().** is call
0440: 65 64 2e 20 57 68 65 6e 20 73 74 61 74 65 6d 65  ed. When stateme
0450: 6e 74 73 20 61 72 65 20 61 64 64 65 64 20 74 6f  nts are added to
0460: 20 74 68 69 73 20 6c 69 73 74 2c 20 74 68 65 20   this list, the 
0470: 61 73 73 6f 63 69 61 74 65 64 20 0a 2a 2a 20 72  associated .** r
0480: 65 67 69 73 74 65 72 20 61 72 72 61 79 20 28 70  egister array (p
0490: 2d 3e 61 4d 65 6d 5b 31 2e 2e 70 2d 3e 6e 4d 65  ->aMem[1..p->nMe
04a0: 6d 5d 29 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20  m]) may contain 
04b0: 64 79 6e 61 6d 69 63 20 62 75 66 66 65 72 73 20  dynamic buffers 
04c0: 74 68 61 74 0a 2a 2a 20 63 61 6e 20 62 65 20 66  that.** can be f
04d0: 72 65 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74  reed using sqlit
04e0: 65 33 56 64 62 65 52 65 6c 65 61 73 65 4d 65 6d  e3VdbeReleaseMem
04f0: 6f 72 79 28 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65  ory()..**.** Whe
0500: 6e 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65  n statements are
0510: 20 61 64 64 65 64 20 6f 72 20 72 65 6d 6f 76 65   added or remove
0520: 64 20 66 72 6f 6d 20 74 68 69 73 20 6c 69 73 74  d from this list
0530: 2c 20 74 68 65 20 6d 75 74 65 78 0a 2a 2a 20 61  , the mutex.** a
0540: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74  ssociated with t
0550: 68 65 20 56 64 62 65 20 62 65 69 6e 67 20 61 64  he Vdbe being ad
0560: 64 65 64 20 6f 72 20 72 65 6d 6f 76 65 64 20 28  ded or removed (
0570: 56 64 62 65 2e 64 62 2d 3e 6d 75 74 65 78 29 20  Vdbe.db->mutex) 
0580: 69 73 0a 2a 2a 20 61 6c 72 65 61 64 79 20 68 65  is.** already he
0590: 6c 64 2e 20 54 68 65 20 4c 52 55 32 20 6d 75 74  ld. The LRU2 mut
05a0: 65 78 20 69 73 20 74 68 65 6e 20 6f 62 74 61 69  ex is then obtai
05b0: 6e 65 64 2c 20 62 6c 6f 63 6b 69 6e 67 20 69 66  ned, blocking if
05c0: 20 6e 65 63 65 73 73 61 72 79 2c 0a 2a 2a 20 74   necessary,.** t
05d0: 68 65 20 6c 69 6e 6b 65 64 2d 6c 69 73 74 20 70  he linked-list p
05e0: 6f 69 6e 74 65 72 73 20 6d 61 6e 69 70 75 6c 61  ointers manipula
05f0: 74 65 64 20 61 6e 64 20 74 68 65 20 4c 52 55 32  ted and the LRU2
0600: 20 6d 75 74 65 78 20 72 65 6c 69 6e 71 75 69 73   mutex relinquis
0610: 68 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53  hed..*/.struct S
0620: 74 61 74 65 6d 65 6e 74 4c 72 75 4c 69 73 74 20  tatementLruList 
0630: 7b 0a 20 20 56 64 62 65 20 2a 70 46 69 72 73 74  {.  Vdbe *pFirst
0640: 3b 0a 20 20 56 64 62 65 20 2a 70 4c 61 73 74 3b  ;.  Vdbe *pLast;
0650: 0a 7d 3b 0a 73 74 61 74 69 63 20 73 74 72 75 63  .};.static struc
0660: 74 20 53 74 61 74 65 6d 65 6e 74 4c 72 75 4c 69  t StatementLruLi
0670: 73 74 20 73 71 6c 69 74 65 33 4c 72 75 53 74 61  st sqlite3LruSta
0680: 74 65 6d 65 6e 74 73 3b 0a 0a 2f 2a 0a 2a 2a 20  tements;../*.** 
0690: 43 68 65 63 6b 20 74 68 61 74 20 74 68 65 20 6c  Check that the l
06a0: 69 73 74 20 6c 6f 6f 6b 73 20 74 6f 20 62 65 20  ist looks to be 
06b0: 69 6e 74 65 72 6e 61 6c 6c 79 20 63 6f 6e 73 69  internally consi
06c0: 73 74 65 6e 74 2e 20 54 68 69 73 20 69 73 20 75  stent. This is u
06d0: 73 65 64 0a 2a 2a 20 61 73 20 70 61 72 74 20 6f  sed.** as part o
06e0: 66 20 61 6e 20 61 73 73 65 72 74 28 29 20 73 74  f an assert() st
06f0: 61 74 65 6d 65 6e 74 20 61 73 20 66 6f 6c 6c 6f  atement as follo
0700: 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 73 73 65  ws:.**.**   asse
0710: 72 74 28 20 73 74 6d 74 4c 72 75 43 68 65 63 6b  rt( stmtLruCheck
0720: 28 29 20 29 3b 0a 2a 2f 0a 23 69 66 6e 64 65 66  () );.*/.#ifndef
0730: 20 4e 44 45 42 55 47 0a 73 74 61 74 69 63 20 69   NDEBUG.static i
0740: 6e 74 20 73 74 6d 74 4c 72 75 43 68 65 63 6b 28  nt stmtLruCheck(
0750: 29 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a 20 20  ){.  Vdbe *p;.  
0760: 66 6f 72 28 70 3d 73 71 6c 69 74 65 33 4c 72 75  for(p=sqlite3Lru
0770: 53 74 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73  Statements.pFirs
0780: 74 3b 20 70 3b 20 70 3d 70 2d 3e 70 4c 72 75 4e  t; p; p=p->pLruN
0790: 65 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74  ext){.    assert
07a0: 28 70 2d 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20  (p->pLruNext || 
07b0: 70 3d 3d 73 71 6c 69 74 65 33 4c 72 75 53 74 61  p==sqlite3LruSta
07c0: 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 29 3b 0a  tements.pLast);.
07d0: 20 20 20 20 61 73 73 65 72 74 28 21 70 2d 3e 70      assert(!p->p
07e0: 4c 72 75 4e 65 78 74 20 7c 7c 20 70 2d 3e 70 4c  LruNext || p->pL
07f0: 72 75 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76  ruNext->pLruPrev
0800: 3d 3d 70 29 3b 0a 20 20 20 20 61 73 73 65 72 74  ==p);.    assert
0810: 28 70 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20  (p->pLruPrev || 
0820: 70 3d 3d 73 71 6c 69 74 65 33 4c 72 75 53 74 61  p==sqlite3LruSta
0830: 74 65 6d 65 6e 74 73 2e 70 46 69 72 73 74 29 3b  tements.pFirst);
0840: 0a 20 20 20 20 61 73 73 65 72 74 28 21 70 2d 3e  .    assert(!p->
0850: 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 2d 3e 70  pLruPrev || p->p
0860: 4c 72 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 78  LruPrev->pLruNex
0870: 74 3d 3d 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74  t==p);.  }.  ret
0880: 75 72 6e 20 31 3b 0a 7d 0a 23 65 6e 64 69 66 0a  urn 1;.}.#endif.
0890: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 76 64 62 65 20  ./*.** Add vdbe 
08a0: 70 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20  p to the end of 
08b0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6c 72  the statement lr
08c0: 75 20 6c 69 73 74 2e 20 49 74 20 69 73 20 61 73  u list. It is as
08d0: 73 75 6d 65 64 20 74 68 61 74 0a 2a 2a 20 70 20  sumed that.** p 
08e0: 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 70  is not already p
08f0: 61 72 74 20 6f 66 20 74 68 65 20 6c 69 73 74 20  art of the list 
0900: 77 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c  when this is cal
0910: 6c 65 64 2e 20 54 68 65 20 6c 72 75 20 6c 69 73  led. The lru lis
0920: 74 0a 2a 2a 20 69 73 20 70 72 6f 74 65 63 74 65  t.** is protecte
0930: 64 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f  d by the SQLITE_
0940: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
0950: 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74 69   mutex..*/.stati
0960: 63 20 76 6f 69 64 20 73 74 6d 74 4c 72 75 41 64  c void stmtLruAd
0970: 64 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71  d(Vdbe *p){.  sq
0980: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
0990: 72 28 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c  r(sqlite3MutexAl
09a0: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58  loc(SQLITE_MUTEX
09b0: 5f 53 54 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a  _STATIC_LRU2));.
09c0: 0a 20 20 69 66 28 20 70 2d 3e 70 4c 72 75 50 72  .  if( p->pLruPr
09d0: 65 76 20 7c 7c 20 70 2d 3e 70 4c 72 75 4e 65 78  ev || p->pLruNex
09e0: 74 20 7c 7c 20 73 71 6c 69 74 65 33 4c 72 75 53  t || sqlite3LruS
09f0: 74 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73 74  tatements.pFirst
0a00: 3d 3d 70 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ==p ){.    sqlit
0a10: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73  e3_mutex_leave(s
0a20: 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63  qlite3MutexAlloc
0a30: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54  (SQLITE_MUTEX_ST
0a40: 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 20 20 20  ATIC_LRU2));.   
0a50: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 0a 20 20   return;.  }..  
0a60: 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72 75 43  assert( stmtLruC
0a70: 68 65 63 6b 28 29 20 29 3b 0a 0a 20 20 69 66 28  heck() );..  if(
0a80: 20 21 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74   !sqlite3LruStat
0a90: 65 6d 65 6e 74 73 2e 70 46 69 72 73 74 20 29 7b  ements.pFirst ){
0aa0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 73 71  .    assert( !sq
0ab0: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0ac0: 74 73 2e 70 4c 61 73 74 20 29 3b 0a 20 20 20 20  ts.pLast );.    
0ad0: 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d  sqlite3LruStatem
0ae0: 65 6e 74 73 2e 70 46 69 72 73 74 20 3d 20 70 3b  ents.pFirst = p;
0af0: 0a 20 20 20 20 73 71 6c 69 74 65 33 4c 72 75 53  .    sqlite3LruS
0b00: 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 20  tatements.pLast 
0b10: 3d 20 70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = p;.  }else{.  
0b20: 20 20 61 73 73 65 72 74 28 20 21 73 71 6c 69 74    assert( !sqlit
0b30: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
0b40: 70 4c 61 73 74 2d 3e 70 4c 72 75 4e 65 78 74 20  pLast->pLruNext 
0b50: 29 3b 0a 20 20 20 20 70 2d 3e 70 4c 72 75 50 72  );.    p->pLruPr
0b60: 65 76 20 3d 20 73 71 6c 69 74 65 33 4c 72 75 53  ev = sqlite3LruS
0b70: 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 3b  tatements.pLast;
0b80: 0a 20 20 20 20 73 71 6c 69 74 65 33 4c 72 75 53  .    sqlite3LruS
0b90: 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 2d  tatements.pLast-
0ba0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 70 3b 0a 20  >pLruNext = p;. 
0bb0: 20 20 20 73 71 6c 69 74 65 33 4c 72 75 53 74 61     sqlite3LruSta
0bc0: 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 20 3d 20  tements.pLast = 
0bd0: 70 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74  p;.  }..  assert
0be0: 28 20 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29  ( stmtLruCheck()
0bf0: 20 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d   );..  sqlite3_m
0c00: 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74  utex_leave(sqlit
0c10: 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c  e3MutexAlloc(SQL
0c20: 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43  ITE_MUTEX_STATIC
0c30: 5f 4c 52 55 32 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  _LRU2));.}../*.*
0c40: 2a 20 41 73 73 75 6d 69 6e 67 20 74 68 65 20 53  * Assuming the S
0c50: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
0c60: 49 43 5f 4c 52 55 32 20 6d 75 74 65 78 74 20 69  IC_LRU2 mutext i
0c70: 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 2c 20  s already held, 
0c80: 72 65 6d 6f 76 65 0a 2a 2a 20 73 74 61 74 65 6d  remove.** statem
0c90: 65 6e 74 20 70 20 66 72 6f 6d 20 74 68 65 20 6c  ent p from the l
0ca0: 65 61 73 74 2d 72 65 63 65 6e 74 6c 79 2d 75 73  east-recently-us
0cb0: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6c 69 73  ed statement lis
0cc0: 74 2e 20 49 66 20 74 68 65 20 0a 2a 2a 20 73 74  t. If the .** st
0cd0: 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f 74 20 63  atement is not c
0ce0: 75 72 72 65 6e 74 6c 79 20 70 61 72 74 20 6f 66  urrently part of
0cf0: 20 74 68 65 20 6c 69 73 74 2c 20 74 68 69 73 20   the list, this 
0d00: 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  call is a no-op.
0d10: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
0d20: 73 74 6d 74 4c 72 75 52 65 6d 6f 76 65 4e 6f 6d  stmtLruRemoveNom
0d30: 75 74 65 78 28 56 64 62 65 20 2a 70 29 7b 0a 20  utex(Vdbe *p){. 
0d40: 20 69 66 28 20 70 2d 3e 70 4c 72 75 50 72 65 76   if( p->pLruPrev
0d50: 20 7c 7c 20 70 2d 3e 70 4c 72 75 4e 65 78 74 20   || p->pLruNext 
0d60: 7c 7c 20 70 3d 3d 73 71 6c 69 74 65 33 4c 72 75  || p==sqlite3Lru
0d70: 53 74 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73  Statements.pFirs
0d80: 74 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28  t ){.    assert(
0d90: 20 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29 20   stmtLruCheck() 
0da0: 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 70 4c  );.    if( p->pL
0db0: 72 75 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20  ruNext ){.      
0dc0: 70 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c 72  p->pLruNext->pLr
0dd0: 75 50 72 65 76 20 3d 20 70 2d 3e 70 4c 72 75 50  uPrev = p->pLruP
0de0: 72 65 76 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  rev;.    }else{.
0df0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4c 72 75        sqlite3Lru
0e00: 53 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74  Statements.pLast
0e10: 20 3d 20 70 2d 3e 70 4c 72 75 50 72 65 76 3b 0a   = p->pLruPrev;.
0e20: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 2d      }.    if( p-
0e30: 3e 70 4c 72 75 50 72 65 76 20 29 7b 0a 20 20 20  >pLruPrev ){.   
0e40: 20 20 20 70 2d 3e 70 4c 72 75 50 72 65 76 2d 3e     p->pLruPrev->
0e50: 70 4c 72 75 4e 65 78 74 20 3d 20 70 2d 3e 70 4c  pLruNext = p->pL
0e60: 72 75 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c 73  ruNext;.    }els
0e70: 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  e{.      sqlite3
0e80: 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 46  LruStatements.pF
0e90: 69 72 73 74 20 3d 20 70 2d 3e 70 4c 72 75 4e 65  irst = p->pLruNe
0ea0: 78 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d  xt;.    }.    p-
0eb0: 3e 70 4c 72 75 4e 65 78 74 20 3d 20 30 3b 0a 20  >pLruNext = 0;. 
0ec0: 20 20 20 70 2d 3e 70 4c 72 75 50 72 65 76 20 3d     p->pLruPrev =
0ed0: 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   0;.    assert( 
0ee0: 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29 20 29  stmtLruCheck() )
0ef0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  ;.  }.}../*.** A
0f00: 73 73 75 6d 69 6e 67 20 74 68 65 20 53 51 4c 49  ssuming the SQLI
0f10: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f  TE_MUTEX_STATIC_
0f20: 4c 52 55 32 20 6d 75 74 65 78 74 20 69 73 20 6e  LRU2 mutext is n
0f30: 6f 74 20 68 65 6c 64 2c 20 72 65 6d 6f 76 65 0a  ot held, remove.
0f40: 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 20 66  ** statement p f
0f50: 72 6f 6d 20 74 68 65 20 6c 65 61 73 74 2d 72 65  rom the least-re
0f60: 63 65 6e 74 6c 79 2d 75 73 65 64 20 73 74 61 74  cently-used stat
0f70: 65 6d 65 6e 74 20 6c 69 73 74 2e 20 49 66 20 74  ement list. If t
0f80: 68 65 20 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74  he .** statement
0f90: 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c   is not currentl
0fa0: 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 6c 69  y part of the li
0fb0: 73 74 2c 20 74 68 69 73 20 63 61 6c 6c 20 69 73  st, this call is
0fc0: 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61   a no-op..*/.sta
0fd0: 74 69 63 20 76 6f 69 64 20 73 74 6d 74 4c 72 75  tic void stmtLru
0fe0: 52 65 6d 6f 76 65 28 56 64 62 65 20 2a 70 29 7b  Remove(Vdbe *p){
0ff0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
1000: 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 4d 75  _enter(sqlite3Mu
1010: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  texAlloc(SQLITE_
1020: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55  MUTEX_STATIC_LRU
1030: 32 29 29 3b 0a 20 20 73 74 6d 74 4c 72 75 52 65  2));.  stmtLruRe
1040: 6d 6f 76 65 4e 6f 6d 75 74 65 78 28 70 29 3b 0a  moveNomutex(p);.
1050: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
1060: 6c 65 61 76 65 28 73 71 6c 69 74 65 33 4d 75 74  leave(sqlite3Mut
1070: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d  exAlloc(SQLITE_M
1080: 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32  UTEX_STATIC_LRU2
1090: 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79  ));.}../*.** Try
10a0: 20 74 6f 20 72 65 6c 65 61 73 65 20 6e 20 62 79   to release n by
10b0: 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 62 79  tes of memory by
10c0: 20 66 72 65 65 69 6e 67 20 62 75 66 66 65 72 73   freeing buffers
10d0: 20 61 73 73 6f 63 69 61 74 65 64 20 0a 2a 2a 20   associated .** 
10e0: 77 69 74 68 20 74 68 65 20 6d 65 6d 6f 72 79 20  with the memory 
10f0: 72 65 67 69 73 74 65 72 73 20 6f 66 20 63 75 72  registers of cur
1100: 72 65 6e 74 6c 79 20 75 6e 75 73 65 64 20 76 64  rently unused vd
1110: 62 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  bes..*/.int sqli
1120: 74 65 33 56 64 62 65 52 65 6c 65 61 73 65 4d 65  te3VdbeReleaseMe
1130: 6d 6f 72 79 28 69 6e 74 20 6e 29 7b 0a 20 20 56  mory(int n){.  V
1140: 64 62 65 20 2a 70 3b 0a 20 20 56 64 62 65 20 2a  dbe *p;.  Vdbe *
1150: 70 4e 65 78 74 3b 0a 20 20 69 6e 74 20 6e 46 72  pNext;.  int nFr
1160: 65 65 20 3d 20 30 3b 0a 0a 20 20 73 71 6c 69 74  ee = 0;..  sqlit
1170: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73  e3_mutex_enter(s
1180: 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63  qlite3MutexAlloc
1190: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54  (SQLITE_MUTEX_ST
11a0: 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 20 20 66  ATIC_LRU2));.  f
11b0: 6f 72 28 70 3d 73 71 6c 69 74 65 33 4c 72 75 53  or(p=sqlite3LruS
11c0: 74 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73 74  tatements.pFirst
11d0: 3b 20 70 20 26 26 20 6e 46 72 65 65 3c 6e 3b 20  ; p && nFree<n; 
11e0: 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e  p=pNext){.    pN
11f0: 65 78 74 20 3d 20 70 2d 3e 70 4c 72 75 4e 65 78  ext = p->pLruNex
1200: 74 3b 0a 0a 20 20 20 20 2f 2a 20 46 6f 72 20 65  t;..    /* For e
1210: 61 63 68 20 73 74 61 74 65 6d 65 6e 74 20 68 61  ach statement ha
1220: 6e 64 6c 65 20 69 6e 20 74 68 65 20 6c 72 75 20  ndle in the lru 
1230: 6c 69 73 74 2c 20 61 74 74 65 6d 70 74 20 74 6f  list, attempt to
1240: 20 6f 62 74 61 69 6e 20 74 68 65 0a 20 20 20 20   obtain the.    
1250: 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 64 61  ** associated da
1260: 74 61 62 61 73 65 20 6d 75 74 65 78 2e 20 49 66  tabase mutex. If
1270: 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 6f 62   it cannot be ob
1280: 74 61 69 6e 65 64 2c 20 63 6f 6e 74 69 6e 75 65  tained, continue
1290: 0a 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 6e  .    ** to the n
12a0: 65 78 74 20 73 74 61 74 65 6d 65 6e 74 20 68 61  ext statement ha
12b0: 6e 64 6c 65 2e 20 49 74 20 69 73 20 6e 6f 74 20  ndle. It is not 
12c0: 70 6f 73 73 69 62 6c 65 20 74 6f 20 62 6c 6f 63  possible to bloc
12d0: 6b 20 6f 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20  k on.    ** the 
12e0: 64 61 74 61 62 61 73 65 20 6d 75 74 65 78 20 2d  database mutex -
12f0: 20 74 68 61 74 20 63 6f 75 6c 64 20 63 61 75 73   that could caus
1300: 65 20 64 65 61 64 6c 6f 63 6b 2e 0a 20 20 20 20  e deadlock..    
1310: 2a 2f 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54  */.    if( SQLIT
1320: 45 5f 4f 4b 3d 3d 73 71 6c 69 74 65 33 5f 6d 75  E_OK==sqlite3_mu
1330: 74 65 78 5f 74 72 79 28 70 2d 3e 64 62 2d 3e 6d  tex_try(p->db->m
1340: 75 74 65 78 29 20 29 7b 0a 20 20 20 20 20 20 6e  utex) ){.      n
1350: 46 72 65 65 20 2b 3d 20 73 71 6c 69 74 65 33 56  Free += sqlite3V
1360: 64 62 65 52 65 6c 65 61 73 65 42 75 66 66 65 72  dbeReleaseBuffer
1370: 73 28 70 29 3b 0a 20 20 20 20 20 20 73 74 6d 74  s(p);.      stmt
1380: 4c 72 75 52 65 6d 6f 76 65 4e 6f 6d 75 74 65 78  LruRemoveNomutex
1390: 28 70 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  (p);.      sqlit
13a0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
13b0: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  ->db->mutex);.  
13c0: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65    }.  }.  sqlite
13d0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71  3_mutex_leave(sq
13e0: 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28  lite3MutexAlloc(
13f0: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
1400: 54 49 43 5f 4c 52 55 32 29 29 3b 0a 0a 20 20 72  TIC_LRU2));..  r
1410: 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a 7d 0a 0a  eturn nFree;.}..
1420: 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 73 71 6c 69 74  /*.** Call sqlit
1430: 65 33 52 65 70 72 65 70 61 72 65 28 29 20 6f 6e  e3Reprepare() on
1440: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 2e 20   the statement. 
1450: 52 65 6d 6f 76 65 20 69 74 20 66 72 6f 6d 20 74  Remove it from t
1460: 68 65 0a 2a 2a 20 6c 72 75 20 6c 69 73 74 20 62  he.** lru list b
1470: 65 66 6f 72 65 20 64 6f 69 6e 67 20 73 6f 2c 20  efore doing so, 
1480: 61 73 20 52 65 70 72 65 70 61 72 65 28 29 20 77  as Reprepare() w
1490: 69 6c 6c 20 66 72 65 65 20 61 6c 6c 20 74 68 65  ill free all the
14a0: 0a 2a 2a 20 6d 65 6d 6f 72 79 20 72 65 67 69 73  .** memory regis
14b0: 74 65 72 20 62 75 66 66 65 72 73 20 61 6e 79 77  ter buffers anyw
14c0: 61 79 2e 0a 2a 2f 0a 69 6e 74 20 76 64 62 65 52  ay..*/.int vdbeR
14d0: 65 70 72 65 70 61 72 65 28 56 64 62 65 20 2a 70  eprepare(Vdbe *p
14e0: 29 7b 0a 20 20 73 74 6d 74 4c 72 75 52 65 6d 6f  ){.  stmtLruRemo
14f0: 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20  ve(p);.  return 
1500: 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 65  sqlite3Reprepare
1510: 28 70 29 3b 0a 7d 0a 0a 23 65 6c 73 65 20 20 20  (p);.}..#else   
1520: 20 20 20 20 2f 2a 20 21 53 51 4c 49 54 45 5f 45      /* !SQLITE_E
1530: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
1540: 41 47 45 4d 45 4e 54 20 2a 2f 0a 20 20 23 64 65  AGEMENT */.  #de
1550: 66 69 6e 65 20 73 74 6d 74 4c 72 75 52 65 6d 6f  fine stmtLruRemo
1560: 76 65 28 78 29 0a 20 20 23 64 65 66 69 6e 65 20  ve(x).  #define 
1570: 73 74 6d 74 4c 72 75 41 64 64 28 78 29 0a 20 20  stmtLruAdd(x).  
1580: 23 64 65 66 69 6e 65 20 76 64 62 65 52 65 70 72  #define vdbeRepr
1590: 65 70 61 72 65 28 78 29 20 73 71 6c 69 74 65 33  epare(x) sqlite3
15a0: 52 65 70 72 65 70 61 72 65 28 78 29 0a 23 65 6e  Reprepare(x).#en
15b0: 64 69 66 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51  dif...#ifndef SQ
15c0: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43  LITE_OMIT_DEPREC
15d0: 41 54 45 44 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ATED./*.** Retur
15e0: 6e 20 54 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f  n TRUE (non-zero
15f0: 29 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65  ) of the stateme
1600: 6e 74 20 73 75 70 70 6c 69 65 64 20 61 73 20 61  nt supplied as a
1610: 6e 20 61 72 67 75 6d 65 6e 74 20 6e 65 65 64 73  n argument needs
1620: 0a 2a 2a 20 74 6f 20 62 65 20 72 65 63 6f 6d 70  .** to be recomp
1630: 69 6c 65 64 2e 20 20 41 20 73 74 61 74 65 6d 65  iled.  A stateme
1640: 6e 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72  nt needs to be r
1650: 65 63 6f 6d 70 69 6c 65 64 20 77 68 65 6e 65 76  ecompiled whenev
1660: 65 72 20 74 68 65 0a 2a 2a 20 65 78 65 63 75 74  er the.** execut
1670: 69 6f 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  ion environment 
1680: 63 68 61 6e 67 65 73 20 69 6e 20 61 20 77 61 79  changes in a way
1690: 20 74 68 61 74 20 77 6f 75 6c 64 20 61 6c 74 65   that would alte
16a0: 72 20 74 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a  r the program.**
16b0: 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f 70 72   that sqlite3_pr
16c0: 65 70 61 72 65 28 29 20 67 65 6e 65 72 61 74 65  epare() generate
16d0: 73 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c  s.  For example,
16e0: 20 69 66 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e   if new function
16f0: 73 20 6f 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e  s or.** collatin
1700: 67 20 73 65 71 75 65 6e 63 65 73 20 61 72 65 20  g sequences are 
1710: 72 65 67 69 73 74 65 72 65 64 20 6f 72 20 69 66  registered or if
1720: 20 61 6e 20 61 75 74 68 6f 72 69 7a 65 72 20 66   an authorizer f
1730: 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64  unction is.** ad
1740: 64 65 64 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a  ded or changed..
1750: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65  */.int sqlite3_e
1760: 78 70 69 72 65 64 28 73 71 6c 69 74 65 33 5f 73  xpired(sqlite3_s
1770: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56  tmt *pStmt){.  V
1780: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29  dbe *p = (Vdbe*)
1790: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20  pStmt;.  return 
17a0: 70 3d 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72  p==0 || p->expir
17b0: 65 64 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a  ed;.}.#endif../*
17c0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
17d0: 67 20 72 6f 75 74 69 6e 65 20 64 65 73 74 72 6f  g routine destro
17e0: 79 73 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63  ys a virtual mac
17f0: 68 69 6e 65 20 74 68 61 74 20 69 73 20 63 72 65  hine that is cre
1800: 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 73  ated by.** the s
1810: 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29  qlite3_compile()
1820: 20 72 6f 75 74 69 6e 65 2e 20 54 68 65 20 69 6e   routine. The in
1830: 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20 69  teger returned i
1840: 73 20 61 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20  s an SQLITE_.** 
1850: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20  success/failure 
1860: 63 6f 64 65 20 74 68 61 74 20 64 65 73 63 72 69  code that descri
1870: 62 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f  bes the result o
1880: 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  f executing the 
1890: 76 69 72 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69  virtual.** machi
18a0: 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ne..**.** This r
18b0: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
18c0: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 73  error code and s
18d0: 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20 62  tring returned b
18e0: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72 72  y.** sqlite3_err
18f0: 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33 5f  code(), sqlite3_
1900: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c  errmsg() and sql
1910: 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29 2e  ite3_errmsg16().
1920: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
1930: 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65 33  finalize(sqlite3
1940: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
1950: 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 70   int rc;.  if( p
1960: 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72  Stmt==0 ){.    r
1970: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
1980: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 56 64 62 65   }else{.    Vdbe
1990: 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74   *v = (Vdbe*)pSt
19a0: 6d 74 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 54  mt;.#if SQLITE_T
19b0: 48 52 45 41 44 53 41 46 45 0a 20 20 20 20 73 71  HREADSAFE.    sq
19c0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74  lite3_mutex *mut
19d0: 65 78 20 3d 20 76 2d 3e 64 62 2d 3e 6d 75 74 65  ex = v->db->mute
19e0: 78 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71  x;.#endif.    sq
19f0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
1a00: 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 73 74  r(mutex);.    st
1a10: 6d 74 4c 72 75 52 65 6d 6f 76 65 28 76 29 3b 0a  mtLruRemove(v);.
1a20: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
1a30: 56 64 62 65 46 69 6e 61 6c 69 7a 65 28 76 29 3b  VdbeFinalize(v);
1a40: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
1a50: 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 29 3b  ex_leave(mutex);
1a60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
1a70: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69  ;.}../*.** Termi
1a80: 6e 61 74 65 20 74 68 65 20 63 75 72 72 65 6e 74  nate the current
1a90: 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 61 6e   execution of an
1aa0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 61   SQL statement a
1ab0: 6e 64 20 72 65 73 65 74 20 69 74 0a 2a 2a 20 62  nd reset it.** b
1ac0: 61 63 6b 20 74 6f 20 69 74 73 20 73 74 61 72 74  ack to its start
1ad0: 69 6e 67 20 73 74 61 74 65 20 73 6f 20 74 68 61  ing state so tha
1ae0: 74 20 69 74 20 63 61 6e 20 62 65 20 72 65 75 73  t it can be reus
1af0: 65 64 2e 20 41 20 73 75 63 63 65 73 73 20 63 6f  ed. A success co
1b00: 64 65 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 70  de from.** the p
1b10: 72 69 6f 72 20 65 78 65 63 75 74 69 6f 6e 20 69  rior execution i
1b20: 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a  s returned..**.*
1b30: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
1b40: 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 63 6f  ets the error co
1b50: 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20 72 65  de and string re
1b60: 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c  turned by.** sql
1b70: 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 2c 20  ite3_errcode(), 
1b80: 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 29  sqlite3_errmsg()
1b90: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65 72 72   and sqlite3_err
1ba0: 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20  msg16()..*/.int 
1bb0: 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 73 71  sqlite3_reset(sq
1bc0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
1bd0: 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  t){.  int rc;.  
1be0: 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a  if( pStmt==0 ){.
1bf0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
1c00: 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  OK;.  }else{.   
1c10: 20 56 64 62 65 20 2a 76 20 3d 20 28 56 64 62 65   Vdbe *v = (Vdbe
1c20: 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20 73 71 6c  *)pStmt;.    sql
1c30: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
1c40: 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (v->db->mutex);.
1c50: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
1c60: 56 64 62 65 52 65 73 65 74 28 76 29 3b 0a 20 20  VdbeReset(v);.  
1c70: 20 20 73 74 6d 74 4c 72 75 41 64 64 28 76 29 3b    stmtLruAdd(v);
1c80: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
1c90: 4d 61 6b 65 52 65 61 64 79 28 76 2c 20 2d 31 2c  MakeReady(v, -1,
1ca0: 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 61   0, 0, 0);.    a
1cb0: 73 73 65 72 74 28 20 28 72 63 20 26 20 28 76 2d  ssert( (rc & (v-
1cc0: 3e 64 62 2d 3e 65 72 72 4d 61 73 6b 29 29 3d 3d  >db->errMask))==
1cd0: 72 63 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  rc );.    sqlite
1ce0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 76 2d  3_mutex_leave(v-
1cf0: 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d  >db->mutex);.  }
1d00: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
1d10: 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61 6c 6c 20 74  ./*.** Set all t
1d20: 68 65 20 70 61 72 61 6d 65 74 65 72 73 20 69 6e  he parameters in
1d30: 20 74 68 65 20 63 6f 6d 70 69 6c 65 64 20 53 51   the compiled SQ
1d40: 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 4e  L statement to N
1d50: 55 4c 4c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ULL..*/.int sqli
1d60: 74 65 33 5f 63 6c 65 61 72 5f 62 69 6e 64 69 6e  te3_clear_bindin
1d70: 67 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  gs(sqlite3_stmt 
1d80: 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 69  *pStmt){.  int i
1d90: 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
1da0: 49 54 45 5f 4f 4b 3b 0a 20 20 56 64 62 65 20 2a  ITE_OK;.  Vdbe *
1db0: 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74  p = (Vdbe*)pStmt
1dc0: 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52  ;.#if SQLITE_THR
1dd0: 45 41 44 53 41 46 45 0a 20 20 73 71 6c 69 74 65  EADSAFE.  sqlite
1de0: 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 20 3d  3_mutex *mutex =
1df0: 20 28 28 56 64 62 65 2a 29 70 53 74 6d 74 29 2d   ((Vdbe*)pStmt)-
1e00: 3e 64 62 2d 3e 6d 75 74 65 78 3b 0a 23 65 6e 64  >db->mutex;.#end
1e10: 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  if.  sqlite3_mut
1e20: 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 29 3b  ex_enter(mutex);
1e30: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d  .  for(i=0; i<p-
1e40: 3e 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20  >nVar; i++){.   
1e50: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
1e60: 65 6c 65 61 73 65 28 26 70 2d 3e 61 56 61 72 5b  elease(&p->aVar[
1e70: 69 5d 29 3b 0a 20 20 20 20 70 2d 3e 61 56 61 72  i]);.    p->aVar
1e80: 5b 69 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  [i].flags = MEM_
1e90: 4e 75 6c 6c 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  Null;.  }.  sqli
1ea0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
1eb0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e  mutex);.  return
1ec0: 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a   rc;.}.../******
1ed0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1ee0: 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 76  ****** sqlite3_v
1ef0: 61 6c 75 65 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  alue_  *********
1f00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1f10: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f  ******.** The fo
1f20: 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73  llowing routines
1f30: 20 65 78 74 72 61 63 74 20 69 6e 66 6f 72 6d 61   extract informa
1f40: 74 69 6f 6e 20 66 72 6f 6d 20 61 20 4d 65 6d 20  tion from a Mem 
1f50: 6f 72 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  or sqlite3_value
1f60: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  .** structure..*
1f70: 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  /.const void *sq
1f80: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62  lite3_value_blob
1f90: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
1fa0: 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20 2a 70 20  pVal){.  Mem *p 
1fb0: 3d 20 28 4d 65 6d 2a 29 70 56 61 6c 3b 0a 20 20  = (Mem*)pVal;.  
1fc0: 69 66 28 20 70 2d 3e 66 6c 61 67 73 20 26 20 28  if( p->flags & (
1fd0: 4d 45 4d 5f 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72  MEM_Blob|MEM_Str
1fe0: 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ) ){.    sqlite3
1ff0: 56 64 62 65 4d 65 6d 45 78 70 61 6e 64 42 6c 6f  VdbeMemExpandBlo
2000: 62 28 70 29 3b 0a 20 20 20 20 70 2d 3e 66 6c 61  b(p);.    p->fla
2010: 67 73 20 26 3d 20 7e 4d 45 4d 5f 53 74 72 3b 0a  gs &= ~MEM_Str;.
2020: 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 7c 3d 20      p->flags |= 
2030: 4d 45 4d 5f 42 6c 6f 62 3b 0a 20 20 20 20 72 65  MEM_Blob;.    re
2040: 74 75 72 6e 20 70 2d 3e 7a 3b 0a 20 20 7d 65 6c  turn p->z;.  }el
2050: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73  se{.    return s
2060: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
2070: 74 28 70 56 61 6c 29 3b 0a 20 20 7d 0a 7d 0a 69  t(pVal);.  }.}.i
2080: 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  nt sqlite3_value
2090: 5f 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f 76  _bytes(sqlite3_v
20a0: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72  alue *pVal){.  r
20b0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c  eturn sqlite3Val
20c0: 75 65 42 79 74 65 73 28 70 56 61 6c 2c 20 53 51  ueBytes(pVal, SQ
20d0: 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a 69 6e  LITE_UTF8);.}.in
20e0: 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  t sqlite3_value_
20f0: 62 79 74 65 73 31 36 28 73 71 6c 69 74 65 33 5f  bytes16(sqlite3_
2100: 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20  value *pVal){.  
2110: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61  return sqlite3Va
2120: 6c 75 65 42 79 74 65 73 28 70 56 61 6c 2c 20 53  lueBytes(pVal, S
2130: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
2140: 45 29 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73 71 6c  E);.}.double sql
2150: 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c  ite3_value_doubl
2160: 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  e(sqlite3_value 
2170: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e  *pVal){.  return
2180: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 61 6c   sqlite3VdbeReal
2190: 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c  Value((Mem*)pVal
21a0: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
21b0: 5f 76 61 6c 75 65 5f 69 6e 74 28 73 71 6c 69 74  _value_int(sqlit
21c0: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b  e3_value *pVal){
21d0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65  .  return sqlite
21e0: 33 56 64 62 65 49 6e 74 56 61 6c 75 65 28 28 4d  3VdbeIntValue((M
21f0: 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 73 71 6c  em*)pVal);.}.sql
2200: 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 74 65  ite_int64 sqlite
2210: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 73 71  3_value_int64(sq
2220: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
2230: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
2240: 69 74 65 33 56 64 62 65 49 6e 74 56 61 6c 75 65  ite3VdbeIntValue
2250: 28 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a  ((Mem*)pVal);.}.
2260: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
2270: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c  har *sqlite3_val
2280: 75 65 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f  ue_text(sqlite3_
2290: 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20  value *pVal){.  
22a0: 72 65 74 75 72 6e 20 28 63 6f 6e 73 74 20 75 6e  return (const un
22b0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 73 71  signed char *)sq
22c0: 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70  lite3ValueText(p
22d0: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38  Val, SQLITE_UTF8
22e0: 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  );.}.#ifndef SQL
22f0: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63  ITE_OMIT_UTF16.c
2300: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
2310: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28  e3_value_text16(
2320: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70  sqlite3_value* p
2330: 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  Val){.  return s
2340: 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28  qlite3ValueText(
2350: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
2360: 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e  16NATIVE);.}.con
2370: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  st void *sqlite3
2380: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28  _value_text16be(
2390: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70  sqlite3_value *p
23a0: 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  Val){.  return s
23b0: 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28  qlite3ValueText(
23c0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
23d0: 31 36 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76  16BE);.}.const v
23e0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c  oid *sqlite3_val
23f0: 75 65 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69  ue_text16le(sqli
2400: 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29  te3_value *pVal)
2410: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74  {.  return sqlit
2420: 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c  e3ValueText(pVal
2430: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45  , SQLITE_UTF16LE
2440: 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  );.}.#endif /* S
2450: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
2460: 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f   */.int sqlite3_
2470: 76 61 6c 75 65 5f 74 79 70 65 28 73 71 6c 69 74  value_type(sqlit
2480: 65 33 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b  e3_value* pVal){
2490: 0a 20 20 72 65 74 75 72 6e 20 70 56 61 6c 2d 3e  .  return pVal->
24a0: 74 79 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a  type;.}../******
24b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
24c0: 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 72  ****** sqlite3_r
24d0: 65 73 75 6c 74 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a  esult_  ********
24e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
24f0: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66  *******.** The f
2500: 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65  ollowing routine
2510: 73 20 61 72 65 20 75 73 65 64 20 62 79 20 75 73  s are used by us
2520: 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74  er-defined funct
2530: 69 6f 6e 73 20 74 6f 20 73 70 65 63 69 66 79 0a  ions to specify.
2540: 2a 2a 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20  ** the function 
2550: 72 65 73 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20  result..*/.void 
2560: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62  sqlite3_result_b
2570: 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 63  lob(.  sqlite3_c
2580: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20  ontext *pCtx, . 
2590: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20   const void *z, 
25a0: 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69  .  int n, .  voi
25b0: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a  d (*xDel)(void *
25c0: 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e  ).){.  assert( n
25d0: 3e 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  >=0 );.  assert(
25e0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
25f0: 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e  eld(pCtx->s.db->
2600: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69  mutex) );.  sqli
2610: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72  te3VdbeMemSetStr
2620: 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c  (&pCtx->s, z, n,
2630: 20 30 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69   0, xDel);.}.voi
2640: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
2650: 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f  _double(sqlite3_
2660: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 64  context *pCtx, d
2670: 6f 75 62 6c 65 20 72 56 61 6c 29 7b 0a 20 20 61  ouble rVal){.  a
2680: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
2690: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
26a0: 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  s.db->mutex) );.
26b0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
26c0: 53 65 74 44 6f 75 62 6c 65 28 26 70 43 74 78 2d  SetDouble(&pCtx-
26d0: 3e 73 2c 20 72 56 61 6c 29 3b 0a 7d 0a 76 6f 69  >s, rVal);.}.voi
26e0: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
26f0: 5f 65 72 72 6f 72 28 73 71 6c 69 74 65 33 5f 63  _error(sqlite3_c
2700: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f  ontext *pCtx, co
2710: 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74  nst char *z, int
2720: 20 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73   n){.  assert( s
2730: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2740: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2750: 74 65 78 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e  tex) );.  pCtx->
2760: 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45  isError = SQLITE
2770: 5f 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69 74 65  _ERROR;.  sqlite
2780: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
2790: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
27a0: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49  QLITE_UTF8, SQLI
27b0: 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 7d  TE_TRANSIENT);.}
27c0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
27d0: 4f 4d 49 54 5f 55 54 46 31 36 0a 76 6f 69 64 20  OMIT_UTF16.void 
27e0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
27f0: 72 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f 63  rror16(sqlite3_c
2800: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f  ontext *pCtx, co
2810: 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74  nst void *z, int
2820: 20 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73   n){.  assert( s
2830: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2840: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2850: 74 65 78 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e  tex) );.  pCtx->
2860: 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45  isError = SQLITE
2870: 5f 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69 74 65  _ERROR;.  sqlite
2880: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
2890: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
28a0: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
28b0: 45 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e 53 49  E, SQLITE_TRANSI
28c0: 45 4e 54 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 76  ENT);.}.#endif.v
28d0: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
28e0: 6c 74 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 63  lt_int(sqlite3_c
28f0: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e  ontext *pCtx, in
2900: 74 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 65 72  t iVal){.  asser
2910: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
2920: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62  _held(pCtx->s.db
2930: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71  ->mutex) );.  sq
2940: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49  lite3VdbeMemSetI
2950: 6e 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 28  nt64(&pCtx->s, (
2960: 69 36 34 29 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69  i64)iVal);.}.voi
2970: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
2980: 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 63  _int64(sqlite3_c
2990: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 36  ontext *pCtx, i6
29a0: 34 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 65 72  4 iVal){.  asser
29b0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
29c0: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62  _held(pCtx->s.db
29d0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71  ->mutex) );.  sq
29e0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49  lite3VdbeMemSetI
29f0: 6e 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 69  nt64(&pCtx->s, i
2a00: 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Val);.}.void sql
2a10: 69 74 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c  ite3_result_null
2a20: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
2a30: 20 2a 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72   *pCtx){.  asser
2a40: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
2a50: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62  _held(pCtx->s.db
2a60: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71  ->mutex) );.  sq
2a70: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e  lite3VdbeMemSetN
2a80: 75 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b 0a 7d  ull(&pCtx->s);.}
2a90: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
2aa0: 73 75 6c 74 5f 74 65 78 74 28 0a 20 20 73 71 6c  sult_text(.  sql
2ab0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43  ite3_context *pC
2ac0: 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61  tx, .  const cha
2ad0: 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 0a  r *z, .  int n,.
2ae0: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
2af0: 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65  oid *).){.  asse
2b00: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
2b10: 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64  x_held(pCtx->s.d
2b20: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73  b->mutex) );.  s
2b30: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
2b40: 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c  Str(&pCtx->s, z,
2b50: 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c   n, SQLITE_UTF8,
2b60: 20 78 44 65 6c 29 3b 0a 7d 0a 23 69 66 6e 64 65   xDel);.}.#ifnde
2b70: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  f SQLITE_OMIT_UT
2b80: 46 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  F16.void sqlite3
2b90: 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a  _result_text16(.
2ba0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
2bb0: 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73  t *pCtx, .  cons
2bc0: 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e  t void *z, .  in
2bd0: 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  t n, .  void (*x
2be0: 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a  Del)(void *).){.
2bf0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
2c00: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
2c10: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
2c20: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
2c30: 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d  MemSetStr(&pCtx-
2c40: 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45  >s, z, n, SQLITE
2c50: 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 78 44  _UTF16NATIVE, xD
2c60: 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69  el);.}.void sqli
2c70: 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31  te3_result_text1
2c80: 36 62 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 63  6be(.  sqlite3_c
2c90: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20  ontext *pCtx, . 
2ca0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20   const void *z, 
2cb0: 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69  .  int n, .  voi
2cc0: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a  d (*xDel)(void *
2cd0: 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73  ).){.  assert( s
2ce0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2cf0: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2d00: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  tex) );.  sqlite
2d10: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26  3VdbeMemSetStr(&
2d20: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53  pCtx->s, z, n, S
2d30: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 78  QLITE_UTF16BE, x
2d40: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c  Del);.}.void sql
2d50: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
2d60: 31 36 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 5f  16le(.  sqlite3_
2d70: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a  context *pCtx, .
2d80: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c    const void *z,
2d90: 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f   .  int n, .  vo
2da0: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20  id (*xDel)(void 
2db0: 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20  *).){.  assert( 
2dc0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
2dd0: 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d  ld(pCtx->s.db->m
2de0: 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74  utex) );.  sqlit
2df0: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28  e3VdbeMemSetStr(
2e00: 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20  &pCtx->s, z, n, 
2e10: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20  SQLITE_UTF16LE, 
2e20: 78 44 65 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 20  xDel);.}.#endif 
2e30: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
2e40: 54 46 31 36 20 2a 2f 0a 76 6f 69 64 20 73 71 6c  TF16 */.void sql
2e50: 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75  ite3_result_valu
2e60: 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  e(sqlite3_contex
2e70: 74 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65 33  t *pCtx, sqlite3
2e80: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b  _value *pValue){
2e90: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
2ea0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
2eb0: 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29  tx->s.db->mutex)
2ec0: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   );.  sqlite3Vdb
2ed0: 65 4d 65 6d 43 6f 70 79 28 26 70 43 74 78 2d 3e  eMemCopy(&pCtx->
2ee0: 73 2c 20 70 56 61 6c 75 65 29 3b 0a 7d 0a 76 6f  s, pValue);.}.vo
2ef0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
2f00: 74 5f 7a 65 72 6f 62 6c 6f 62 28 73 71 6c 69 74  t_zeroblob(sqlit
2f10: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
2f20: 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 61 73 73 65  , int n){.  asse
2f30: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
2f40: 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64  x_held(pCtx->s.d
2f50: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73  b->mutex) );.  s
2f60: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
2f70: 5a 65 72 6f 42 6c 6f 62 28 26 70 43 74 78 2d 3e  ZeroBlob(&pCtx->
2f80: 73 2c 20 6e 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  s, n);.}.void sq
2f90: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
2fa0: 6f 72 5f 63 6f 64 65 28 73 71 6c 69 74 65 33 5f  or_code(sqlite3_
2fb0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69  context *pCtx, i
2fc0: 6e 74 20 65 72 72 43 6f 64 65 29 7b 0a 20 20 70  nt errCode){.  p
2fd0: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 65  Ctx->isError = e
2fe0: 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a 20 46 6f  rrCode;.}../* Fo
2ff0: 72 63 65 20 61 6e 20 53 51 4c 49 54 45 5f 54 4f  rce an SQLITE_TO
3000: 4f 42 49 47 20 65 72 72 6f 72 2e 20 2a 2f 0a 76  OBIG error. */.v
3010: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
3020: 6c 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 67 28  lt_error_toobig(
3030: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
3040: 2a 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74  *pCtx){.  assert
3050: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3060: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d  held(pCtx->s.db-
3070: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 43 74  >mutex) );.  pCt
3080: 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 53 51 4c  x->isError = SQL
3090: 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20 73 71  ITE_TOOBIG;.  sq
30a0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
30b0: 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 22 73 74  tr(&pCtx->s, "st
30c0: 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 74 6f 6f  ring or blob too
30d0: 20 62 69 67 22 2c 20 2d 31 2c 20 0a 20 20 20 20   big", -1, .    
30e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
30f0: 20 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20     SQLITE_UTF8, 
3100: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
3110: 7d 0a 0a 2f 2a 20 41 6e 20 53 51 4c 49 54 45 5f  }../* An SQLITE_
3120: 4e 4f 4d 45 4d 20 65 72 72 6f 72 2e 20 2a 2f 0a  NOMEM error. */.
3130: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73  void sqlite3_res
3140: 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 6d 28  ult_error_nomem(
3150: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
3160: 2a 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74  *pCtx){.  assert
3170: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3180: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d  held(pCtx->s.db-
3190: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c  >mutex) );.  sql
31a0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e 75  ite3VdbeMemSetNu
31b0: 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b 0a 20 20  ll(&pCtx->s);.  
31c0: 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20  pCtx->isError = 
31d0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
31e0: 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 61 6c 6c  pCtx->s.db->mall
31f0: 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 7d 0a  ocFailed = 1;.}.
3200: 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65 20 74  ./*.** Execute t
3210: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74  he statement pSt
3220: 6d 74 2c 20 65 69 74 68 65 72 20 75 6e 74 69 6c  mt, either until
3230: 20 61 20 72 6f 77 20 6f 66 20 64 61 74 61 20 69   a row of data i
3240: 73 20 72 65 61 64 79 2c 20 74 68 65 0a 2a 2a 20  s ready, the.** 
3250: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 63 6f 6d  statement is com
3260: 70 6c 65 74 65 6c 79 20 65 78 65 63 75 74 65 64  pletely executed
3270: 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   or an error occ
3280: 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  urs..**.** This 
3290: 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e  routine implemen
32a0: 74 73 20 74 68 65 20 62 75 6c 6b 20 6f 66 20 74  ts the bulk of t
32b0: 68 65 20 6c 6f 67 69 63 20 62 65 68 69 6e 64 20  he logic behind 
32c0: 74 68 65 20 73 71 6c 69 74 65 5f 73 74 65 70 28  the sqlite_step(
32d0: 29 0a 2a 2a 20 41 50 49 2e 20 20 54 68 65 20 6f  ).** API.  The o
32e0: 6e 6c 79 20 74 68 69 6e 67 20 6f 6d 69 74 74 65  nly thing omitte
32f0: 64 20 69 73 20 74 68 65 20 61 75 74 6f 6d 61 74  d is the automat
3300: 69 63 20 72 65 63 6f 6d 70 69 6c 65 20 69 66 20  ic recompile if 
3310: 61 20 0a 2a 2a 20 73 63 68 65 6d 61 20 63 68 61  a .** schema cha
3320: 6e 67 65 20 68 61 73 20 6f 63 63 75 72 72 65 64  nge has occurred
3330: 2e 20 20 54 68 61 74 20 64 65 74 61 69 6c 20 69  .  That detail i
3340: 73 20 68 61 6e 64 6c 65 64 20 62 79 20 74 68 65  s handled by the
3350: 0a 2a 2a 20 6f 75 74 65 72 20 73 71 6c 69 74 65  .** outer sqlite
3360: 33 5f 73 74 65 70 28 29 20 77 72 61 70 70 65 72  3_step() wrapper
3370: 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2f 0a 73   procedure..*/.s
3380: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65  tatic int sqlite
3390: 33 53 74 65 70 28 56 64 62 65 20 2a 70 29 7b 0a  3Step(Vdbe *p){.
33a0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
33b0: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65   int rc;..  asse
33c0: 72 74 28 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e  rt(p);.  if( p->
33d0: 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49  magic!=VDBE_MAGI
33e0: 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 72 65 74  C_RUN ){.    ret
33f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
3400: 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 73 73  E;.  }..  /* Ass
3410: 65 72 74 20 74 68 61 74 20 6d 61 6c 6c 6f 63 28  ert that malloc(
3420: 29 20 68 61 73 20 6e 6f 74 20 66 61 69 6c 65 64  ) has not failed
3430: 20 2a 2f 0a 20 20 64 62 20 3d 20 70 2d 3e 64 62   */.  db = p->db
3440: 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c  ;.  if( db->mall
3450: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20  ocFailed ){.    
3460: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
3470: 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  MEM;.  }..  if( 
3480: 70 2d 3e 70 63 3c 3d 30 20 26 26 20 70 2d 3e 65  p->pc<=0 && p->e
3490: 78 70 69 72 65 64 20 29 7b 0a 20 20 20 20 69 66  xpired ){.    if
34a0: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
34b0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 72  OK ){.      p->r
34c0: 63 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  c = SQLITE_SCHEM
34d0: 41 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20  A;.    }.    rc 
34e0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
34f0: 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6f 66 5f      goto end_of_
3500: 73 74 65 70 3b 0a 20 20 7d 0a 20 20 69 66 28 20  step;.  }.  if( 
3510: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
3520: 64 62 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63  db) ){.    p->rc
3530: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
3540: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
3550: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
3560: 20 20 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b    if( p->pc<0 ){
3570: 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65  .    /* If there
3580: 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 73 74   are no other st
3590: 61 74 65 6d 65 6e 74 73 20 63 75 72 72 65 6e 74  atements current
35a0: 6c 79 20 72 75 6e 6e 69 6e 67 2c 20 74 68 65 6e  ly running, then
35b0: 0a 20 20 20 20 2a 2a 20 72 65 73 65 74 20 74 68  .    ** reset th
35c0: 65 20 69 6e 74 65 72 72 75 70 74 20 66 6c 61 67  e interrupt flag
35d0: 2e 20 20 54 68 69 73 20 70 72 65 76 65 6e 74 73  .  This prevents
35e0: 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74   a call to sqlit
35f0: 65 33 5f 69 6e 74 65 72 72 75 70 74 0a 20 20 20  e3_interrupt.   
3600: 20 2a 2a 20 66 72 6f 6d 20 69 6e 74 65 72 72 75   ** from interru
3610: 70 74 69 6e 67 20 61 20 73 74 61 74 65 6d 65 6e  pting a statemen
3620: 74 20 74 68 61 74 20 68 61 73 20 6e 6f 74 20 79  t that has not y
3630: 65 74 20 73 74 61 72 74 65 64 2e 0a 20 20 20 20  et started..    
3640: 2a 2f 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61  */.    if( db->a
3650: 63 74 69 76 65 56 64 62 65 43 6e 74 3d 3d 30 20  ctiveVdbeCnt==0 
3660: 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 75 31 2e  ){.      db->u1.
3670: 69 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d 20  isInterrupted = 
3680: 30 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 6e 64 65  0;.    }..#ifnde
3690: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52  f SQLITE_OMIT_TR
36a0: 41 43 45 0a 20 20 20 20 69 66 28 20 64 62 2d 3e  ACE.    if( db->
36b0: 78 50 72 6f 66 69 6c 65 20 26 26 20 21 64 62 2d  xProfile && !db-
36c0: 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20  >init.busy ){.  
36d0: 20 20 20 20 64 6f 75 62 6c 65 20 72 4e 6f 77 3b      double rNow;
36e0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73  .      sqlite3Os
36f0: 43 75 72 72 65 6e 74 54 69 6d 65 28 64 62 2d 3e  CurrentTime(db->
3700: 70 56 66 73 2c 20 26 72 4e 6f 77 29 3b 0a 20 20  pVfs, &rNow);.  
3710: 20 20 20 20 70 2d 3e 73 74 61 72 74 54 69 6d 65      p->startTime
3720: 20 3d 20 28 72 4e 6f 77 20 2d 20 28 69 6e 74 29   = (rNow - (int)
3730: 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32 34 2e  rNow)*3600.0*24.
3740: 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30 3b 0a  0*1000000000.0;.
3750: 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20      }.#endif..  
3760: 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65    db->activeVdbe
3770: 43 6e 74 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70  Cnt++;.    if( p
3780: 2d 3e 72 65 61 64 4f 6e 6c 79 3d 3d 30 20 29 20  ->readOnly==0 ) 
3790: 64 62 2d 3e 77 72 69 74 65 56 64 62 65 43 6e 74  db->writeVdbeCnt
37a0: 2b 2b 3b 0a 20 20 20 20 70 2d 3e 70 63 20 3d 20  ++;.    p->pc = 
37b0: 30 3b 0a 20 20 20 20 73 74 6d 74 4c 72 75 52 65  0;.    stmtLruRe
37c0: 6d 6f 76 65 28 70 29 3b 0a 20 20 7d 0a 23 69 66  move(p);.  }.#if
37d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
37e0: 5f 45 58 50 4c 41 49 4e 0a 20 20 69 66 28 20 70  _EXPLAIN.  if( p
37f0: 2d 3e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20  ->explain ){.   
3800: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
3810: 65 4c 69 73 74 28 70 29 3b 0a 20 20 7d 65 6c 73  eList(p);.  }els
3820: 65 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  e.#endif /* SQLI
3830: 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 20  TE_OMIT_EXPLAIN 
3840: 2a 2f 0a 20 20 7b 0a 20 20 20 20 72 63 20 3d 20  */.  {.    rc = 
3850: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
3860: 70 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 73  p);.  }..  if( s
3870: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
3880: 64 62 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  db) ){.    rc = 
3890: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20  SQLITE_MISUSE;. 
38a0: 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49   }..#ifndef SQLI
38b0: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 20 20  TE_OMIT_TRACE.  
38c0: 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 70 72  /* Invoke the pr
38d0: 6f 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b 20 69  ofile callback i
38e0: 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 0a 20  f there is one. 
38f0: 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d 53 51   */.  if( rc!=SQ
3900: 4c 49 54 45 5f 52 4f 57 20 26 26 20 64 62 2d 3e  LITE_ROW && db->
3910: 78 50 72 6f 66 69 6c 65 20 26 26 20 21 64 62 2d  xProfile && !db-
3920: 3e 69 6e 69 74 2e 62 75 73 79 20 26 26 20 70 2d  >init.busy && p-
3930: 3e 6e 4f 70 3e 30 0a 20 20 20 20 20 20 20 20 20  >nOp>0.         
3940: 20 20 26 26 20 70 2d 3e 61 4f 70 5b 30 5d 2e 6f    && p->aOp[0].o
3950: 70 63 6f 64 65 3d 3d 4f 50 5f 54 72 61 63 65 20  pcode==OP_Trace 
3960: 26 26 20 70 2d 3e 61 4f 70 5b 30 5d 2e 70 34 2e  && p->aOp[0].p4.
3970: 7a 21 3d 30 20 29 7b 0a 20 20 20 20 64 6f 75 62  z!=0 ){.    doub
3980: 6c 65 20 72 4e 6f 77 3b 0a 20 20 20 20 75 36 34  le rNow;.    u64
3990: 20 65 6c 61 70 73 65 54 69 6d 65 3b 0a 0a 20 20   elapseTime;..  
39a0: 20 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65    sqlite3OsCurre
39b0: 6e 74 54 69 6d 65 28 64 62 2d 3e 70 56 66 73 2c  ntTime(db->pVfs,
39c0: 20 26 72 4e 6f 77 29 3b 0a 20 20 20 20 65 6c 61   &rNow);.    ela
39d0: 70 73 65 54 69 6d 65 20 3d 20 28 72 4e 6f 77 20  pseTime = (rNow 
39e0: 2d 20 28 69 6e 74 29 72 4e 6f 77 29 2a 33 36 30  - (int)rNow)*360
39f0: 30 2e 30 2a 32 34 2e 30 2a 31 30 30 30 30 30 30  0.0*24.0*1000000
3a00: 30 30 30 2e 30 20 2d 20 70 2d 3e 73 74 61 72 74  000.0 - p->start
3a10: 54 69 6d 65 3b 0a 20 20 20 20 64 62 2d 3e 78 50  Time;.    db->xP
3a20: 72 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72 6f 66  rofile(db->pProf
3a30: 69 6c 65 41 72 67 2c 20 70 2d 3e 61 4f 70 5b 30  ileArg, p->aOp[0
3a40: 5d 2e 70 34 2e 7a 2c 20 65 6c 61 70 73 65 54 69  ].p4.z, elapseTi
3a50: 6d 65 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  me);.  }.#endif.
3a60: 0a 20 20 64 62 2d 3e 65 72 72 43 6f 64 65 20 3d  .  db->errCode =
3a70: 20 72 63 3b 0a 20 20 2f 2a 73 71 6c 69 74 65 33   rc;.  /*sqlite3
3a80: 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63 2c  Error(p->db, rc,
3a90: 20 30 29 3b 2a 2f 0a 20 20 70 2d 3e 72 63 20 3d   0);*/.  p->rc =
3aa0: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
3ab0: 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 29 3b 0a 65  p->db, p->rc);.e
3ac0: 6e 64 5f 6f 66 5f 73 74 65 70 3a 0a 20 20 61 73  nd_of_step:.  as
3ad0: 73 65 72 74 28 20 28 72 63 26 30 78 66 66 29 3d  sert( (rc&0xff)=
3ae0: 3d 72 63 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e  =rc );.  if( p->
3af0: 7a 53 71 6c 20 26 26 20 28 72 63 26 30 78 66 66  zSql && (rc&0xff
3b00: 29 3c 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a  )<SQLITE_ROW ){.
3b10: 20 20 20 20 2f 2a 20 54 68 69 73 20 62 65 68 61      /* This beha
3b20: 76 69 6f 72 20 6f 63 63 75 72 73 20 69 66 20 73  vior occurs if s
3b30: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76  qlite3_prepare_v
3b40: 32 28 29 20 77 61 73 20 75 73 65 64 20 74 6f 20  2() was used to 
3b50: 62 75 69 6c 64 0a 20 20 20 20 2a 2a 20 74 68 65  build.    ** the
3b60: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
3b70: 65 6e 74 2e 20 20 52 65 74 75 72 6e 20 65 72 72  ent.  Return err
3b80: 6f 72 20 63 6f 64 65 73 20 64 69 72 65 63 74 6c  or codes directl
3b90: 79 20 2a 2f 0a 20 20 20 20 70 2d 3e 64 62 2d 3e  y */.    p->db->
3ba0: 65 72 72 43 6f 64 65 20 3d 20 70 2d 3e 72 63 3b  errCode = p->rc;
3bb0: 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 45  .    /* sqlite3E
3bc0: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72  rror(p->db, p->r
3bd0: 63 2c 20 30 29 3b 20 2a 2f 0a 20 20 20 20 72 65  c, 0); */.    re
3be0: 74 75 72 6e 20 70 2d 3e 72 63 3b 0a 20 20 7d 65  turn p->rc;.  }e
3bf0: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73  lse{.    /* This
3c00: 20 69 73 20 66 6f 72 20 6c 65 67 61 63 79 20 73   is for legacy s
3c10: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29  qlite3_prepare()
3c20: 20 62 75 69 6c 64 73 20 61 6e 64 20 77 68 65 6e   builds and when
3c30: 20 74 68 65 20 63 6f 64 65 0a 20 20 20 20 2a 2a   the code.    **
3c40: 20 69 73 20 53 51 4c 49 54 45 5f 52 4f 57 20 6f   is SQLITE_ROW o
3c50: 72 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 2a 2f  r SQLITE_DONE */
3c60: 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  .    return rc;.
3c70: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
3c80: 73 20 69 73 20 74 68 65 20 74 6f 70 2d 6c 65 76  s is the top-lev
3c90: 65 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  el implementatio
3ca0: 6e 20 6f 66 20 73 71 6c 69 74 65 33 5f 73 74 65  n of sqlite3_ste
3cb0: 70 28 29 2e 20 20 43 61 6c 6c 0a 2a 2a 20 73 71  p().  Call.** sq
3cc0: 6c 69 74 65 33 53 74 65 70 28 29 20 74 6f 20 64  lite3Step() to d
3cd0: 6f 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 77 6f  o most of the wo
3ce0: 72 6b 2e 20 20 49 66 20 61 20 73 63 68 65 6d 61  rk.  If a schema
3cf0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 0a 2a   error occurs,.*
3d00: 2a 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 52 65  * call sqlite3Re
3d10: 70 72 65 70 61 72 65 28 29 20 61 6e 64 20 74 72  prepare() and tr
3d20: 79 20 61 67 61 69 6e 2e 0a 2a 2f 0a 23 69 66 64  y again..*/.#ifd
3d30: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50  ef SQLITE_OMIT_P
3d40: 41 52 53 45 52 0a 69 6e 74 20 73 71 6c 69 74 65  ARSER.int sqlite
3d50: 33 5f 73 74 65 70 28 73 71 6c 69 74 65 33 5f 73  3_step(sqlite3_s
3d60: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69  tmt *pStmt){.  i
3d70: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d  nt rc = SQLITE_M
3d80: 49 53 55 53 45 3b 0a 20 20 69 66 28 20 70 53 74  ISUSE;.  if( pSt
3d90: 6d 74 20 29 7b 0a 20 20 20 20 56 64 62 65 20 2a  mt ){.    Vdbe *
3da0: 76 3b 0a 20 20 20 20 76 20 3d 20 28 56 64 62 65  v;.    v = (Vdbe
3db0: 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20 73 71 6c  *)pStmt;.    sql
3dc0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
3dd0: 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (v->db->mutex);.
3de0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
3df0: 53 74 65 70 28 76 29 3b 0a 20 20 20 20 73 71 6c  Step(v);.    sql
3e00: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
3e10: 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (v->db->mutex);.
3e20: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
3e30: 0a 7d 0a 23 65 6c 73 65 0a 69 6e 74 20 73 71 6c  .}.#else.int sql
3e40: 69 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74 65  ite3_step(sqlite
3e50: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a  3_stmt *pStmt){.
3e60: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
3e70: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 69 66 28 20  E_MISUSE;.  if( 
3e80: 70 53 74 6d 74 20 29 7b 0a 20 20 20 20 69 6e 74  pStmt ){.    int
3e90: 20 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 56 64   cnt = 0;.    Vd
3ea0: 62 65 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 70  be *v = (Vdbe*)p
3eb0: 53 74 6d 74 3b 0a 20 20 20 20 73 71 6c 69 74 65  Stmt;.    sqlite
3ec0: 33 20 2a 64 62 20 3d 20 76 2d 3e 64 62 3b 0a 20  3 *db = v->db;. 
3ed0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
3ee0: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78  _enter(db->mutex
3ef0: 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 72  );.    while( (r
3f00: 63 20 3d 20 73 71 6c 69 74 65 33 53 74 65 70 28  c = sqlite3Step(
3f10: 76 29 29 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45  v))==SQLITE_SCHE
3f20: 4d 41 0a 20 20 20 20 20 20 20 20 20 20 20 26 26  MA.           &&
3f30: 20 63 6e 74 2b 2b 20 3c 20 35 0a 20 20 20 20 20   cnt++ < 5.     
3f40: 20 20 20 20 20 20 26 26 20 76 64 62 65 52 65 70        && vdbeRep
3f50: 72 65 70 61 72 65 28 76 29 20 29 7b 0a 20 20 20  repare(v) ){.   
3f60: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74     sqlite3_reset
3f70: 28 70 53 74 6d 74 29 3b 0a 20 20 20 20 20 20 76  (pStmt);.      v
3f80: 2d 3e 65 78 70 69 72 65 64 20 3d 20 30 3b 0a 20  ->expired = 0;. 
3f90: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d     }.    if( rc=
3fa0: 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 26  =SQLITE_SCHEMA &
3fb0: 26 20 76 2d 3e 7a 53 71 6c 20 26 26 20 64 62 2d  & v->zSql && db-
3fc0: 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 20 20 2f  >pErr ){.      /
3fd0: 2a 20 54 68 69 73 20 63 61 73 65 20 6f 63 63 75  * This case occu
3fe0: 72 73 20 61 66 74 65 72 20 66 61 69 6c 69 6e 67  rs after failing
3ff0: 20 74 6f 20 72 65 63 6f 6d 70 69 6c 65 20 61 6e   to recompile an
4000: 20 73 71 6c 20 73 74 61 74 65 6d 65 6e 74 2e 20   sql statement. 
4010: 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 65 72  .      ** The er
4020: 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d  ror message from
4030: 20 74 68 65 20 53 51 4c 20 63 6f 6d 70 69 6c 65   the SQL compile
4040: 72 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65  r has already be
4050: 65 6e 20 6c 6f 61 64 65 64 20 0a 20 20 20 20 20  en loaded .     
4060: 20 2a 2a 20 69 6e 74 6f 20 74 68 65 20 64 61 74   ** into the dat
4070: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 54 68  abase handle. Th
4080: 69 73 20 62 6c 6f 63 6b 20 63 6f 70 69 65 73 20  is block copies 
4090: 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67  the error messag
40a0: 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 72 6f 6d  e .      ** from
40b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
40c0: 6e 64 6c 65 20 69 6e 74 6f 20 74 68 65 20 73 74  ndle into the st
40d0: 61 74 65 6d 65 6e 74 20 61 6e 64 20 73 65 74 73  atement and sets
40e0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 0a 20   the statement. 
40f0: 20 20 20 20 20 2a 2a 20 70 72 6f 67 72 61 6d 20       ** program 
4100: 63 6f 75 6e 74 65 72 20 74 6f 20 30 20 74 6f 20  counter to 0 to 
4110: 65 6e 73 75 72 65 20 74 68 61 74 20 77 68 65 6e  ensure that when
4120: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69   the statement i
4130: 73 20 0a 20 20 20 20 20 20 2a 2a 20 66 69 6e 61  s .      ** fina
4140: 6c 69 7a 65 64 20 6f 72 20 72 65 73 65 74 20 74  lized or reset t
4150: 68 65 20 70 61 72 73 65 72 20 65 72 72 6f 72 20  he parser error 
4160: 6d 65 73 73 61 67 65 20 69 73 20 61 76 61 69 6c  message is avail
4170: 61 62 6c 65 20 76 69 61 0a 20 20 20 20 20 20 2a  able via.      *
4180: 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67  * sqlite3_errmsg
4190: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65  () and sqlite3_e
41a0: 72 72 63 6f 64 65 28 29 2e 0a 20 20 20 20 20 20  rrcode()..      
41b0: 2a 2f 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 63  */.      const c
41c0: 68 61 72 20 2a 7a 45 72 72 20 3d 20 28 63 6f 6e  har *zErr = (con
41d0: 73 74 20 63 68 61 72 20 2a 29 73 71 6c 69 74 65  st char *)sqlite
41e0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d  3_value_text(db-
41f0: 3e 70 45 72 72 29 3b 20 0a 20 20 20 20 20 20 73  >pErr); .      s
4200: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
4210: 20 76 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20   v->zErrMsg);.  
4220: 20 20 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c      if( !db->mal
4230: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
4240: 20 20 20 20 20 76 2d 3e 7a 45 72 72 4d 73 67 20       v->zErrMsg 
4250: 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 75  = sqlite3DbStrDu
4260: 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20 20 20  p(db, zErr);.   
4270: 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20     } else {.    
4280: 20 20 20 20 76 2d 3e 7a 45 72 72 4d 73 67 20 3d      v->zErrMsg =
4290: 20 30 3b 0a 20 20 20 20 20 20 20 20 76 2d 3e 72   0;.        v->r
42a0: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
42b0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
42c0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
42d0: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
42e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
42f0: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74  ex_leave(db->mut
4300: 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  ex);.  }.  retur
4310: 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  n rc;.}.#endif..
4320: 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 20 74 68  /*.** Extract th
4330: 65 20 75 73 65 72 20 64 61 74 61 20 66 72 6f 6d  e user data from
4340: 20 61 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65   a sqlite3_conte
4350: 78 74 20 73 74 72 75 63 74 75 72 65 20 61 6e 64  xt structure and
4360: 20 72 65 74 75 72 6e 20 61 0a 2a 2a 20 70 6f 69   return a.** poi
4370: 6e 74 65 72 20 74 6f 20 69 74 2e 0a 2a 2f 0a 76  nter to it..*/.v
4380: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 73 65  oid *sqlite3_use
4390: 72 5f 64 61 74 61 28 73 71 6c 69 74 65 33 5f 63  r_data(sqlite3_c
43a0: 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 61 73  ontext *p){.  as
43b0: 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70 46  sert( p && p->pF
43c0: 75 6e 63 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  unc );.  return 
43d0: 70 2d 3e 70 46 75 6e 63 2d 3e 70 55 73 65 72 44  p->pFunc->pUserD
43e0: 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78  ata;.}../*.** Ex
43f0: 74 72 61 63 74 20 74 68 65 20 75 73 65 72 20 64  tract the user d
4400: 61 74 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74  ata from a sqlit
4410: 65 33 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63  e3_context struc
4420: 74 75 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20  ture and return 
4430: 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20  a.** pointer to 
4440: 69 74 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 20 2a  it..*/.sqlite3 *
4450: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f  sqlite3_context_
4460: 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c 69 74 65  db_handle(sqlite
4470: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20  3_context *p){. 
4480: 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d   assert( p && p-
4490: 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 65 74 75  >pFunc );.  retu
44a0: 72 6e 20 70 2d 3e 73 2e 64 62 3b 0a 7d 0a 0a 2f  rn p->s.db;.}../
44b0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
44c0: 6e 67 20 69 73 20 74 68 65 20 69 6d 70 6c 65 6d  ng is the implem
44d0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 6e 20 53  entation of an S
44e0: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74  QL function that
44f0: 20 61 6c 77 61 79 73 0a 2a 2a 20 66 61 69 6c 73   always.** fails
4500: 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72 20 6d   with an error m
4510: 65 73 73 61 67 65 20 73 74 61 74 69 6e 67 20 74  essage stating t
4520: 68 61 74 20 74 68 65 20 66 75 6e 63 74 69 6f 6e  hat the function
4530: 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 65 0a   is used in the.
4540: 2a 2a 20 77 72 6f 6e 67 20 63 6f 6e 74 65 78 74  ** wrong context
4550: 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6f  .  The sqlite3_o
4560: 76 65 72 6c 6f 61 64 5f 66 75 6e 63 74 69 6f 6e  verload_function
4570: 28 29 20 41 50 49 20 6d 69 67 68 74 20 63 6f 6e  () API might con
4580: 73 74 72 75 63 74 0a 2a 2a 20 53 51 4c 20 66 75  struct.** SQL fu
4590: 6e 63 74 69 6f 6e 20 74 68 61 74 20 75 73 65 20  nction that use 
45a0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 73 6f 20  this routine so 
45b0: 74 68 61 74 20 74 68 65 20 66 75 6e 63 74 69 6f  that the functio
45c0: 6e 73 20 77 69 6c 6c 20 65 78 69 73 74 0a 2a 2a  ns will exist.**
45d0: 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75   for name resolu
45e0: 74 69 6f 6e 20 62 75 74 20 61 72 65 20 61 63 74  tion but are act
45f0: 75 61 6c 6c 79 20 6f 76 65 72 6c 6f 61 64 65 64  ually overloaded
4600: 20 62 79 20 74 68 65 20 78 46 69 6e 64 46 75 6e   by the xFindFun
4610: 63 74 69 6f 6e 0a 2a 2a 20 6d 65 74 68 6f 64 20  ction.** method 
4620: 6f 66 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65  of virtual table
4630: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  s..*/.void sqlit
4640: 65 33 49 6e 76 61 6c 69 64 46 75 6e 63 74 69 6f  e3InvalidFunctio
4650: 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  n(.  sqlite3_con
4660: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 2c 20 20  text *context,  
4670: 2f 2a 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20  /* The function 
4680: 63 61 6c 6c 69 6e 67 20 63 6f 6e 74 65 78 74 20  calling context 
4690: 2a 2f 0a 20 20 69 6e 74 20 4e 6f 74 55 73 65 64  */.  int NotUsed
46a0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
46b0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67  /* Number of arg
46c0: 75 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 66 75  uments to the fu
46d0: 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69  nction */.  sqli
46e0: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 4e 6f 74 55  te3_value **NotU
46f0: 73 65 64 32 20 20 20 2f 2a 20 56 61 6c 75 65 20  sed2   /* Value 
4700: 6f 66 20 65 61 63 68 20 61 72 67 75 6d 65 6e 74  of each argument
4710: 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63   */.){.  const c
4720: 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 63 6f 6e  har *zName = con
4730: 74 65 78 74 2d 3e 70 46 75 6e 63 2d 3e 7a 4e 61  text->pFunc->zNa
4740: 6d 65 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72  me;.  char *zErr
4750: 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  ;.  UNUSED_PARAM
4760: 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 4e  ETER2(NotUsed, N
4770: 6f 74 55 73 65 64 32 29 3b 0a 20 20 7a 45 72 72  otUsed2);.  zErr
4780: 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74   = sqlite3MPrint
4790: 66 28 30 2c 0a 20 20 20 20 20 20 22 75 6e 61 62  f(0,.      "unab
47a0: 6c 65 20 74 6f 20 75 73 65 20 66 75 6e 63 74 69  le to use functi
47b0: 6f 6e 20 25 73 20 69 6e 20 74 68 65 20 72 65 71  on %s in the req
47c0: 75 65 73 74 65 64 20 63 6f 6e 74 65 78 74 22 2c  uested context",
47d0: 20 7a 4e 61 6d 65 29 3b 0a 20 20 73 71 6c 69 74   zName);.  sqlit
47e0: 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28  e3_result_error(
47f0: 63 6f 6e 74 65 78 74 2c 20 7a 45 72 72 2c 20 2d  context, zErr, -
4800: 31 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  1);.  sqlite3_fr
4810: 65 65 28 7a 45 72 72 29 3b 0a 7d 0a 0a 2f 2a 0a  ee(zErr);.}../*.
4820: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20 72  ** Allocate or r
4830: 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65 67  eturn the aggreg
4840: 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 20  ate context for 
4850: 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e  a user function.
4860: 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 65    A new.** conte
4870: 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20  xt is allocated 
4880: 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  on the first cal
4890: 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20 63  l.  Subsequent c
48a0: 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65 0a  alls return the.
48b0: 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74 20  ** same context 
48c0: 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e 65  that was returne
48d0: 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c 73  d on prior calls
48e0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
48f0: 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e  e3_aggregate_con
4900: 74 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e  text(sqlite3_con
4910: 74 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42 79  text *p, int nBy
4920: 74 65 29 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d  te){.  Mem *pMem
4930: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26  ;.  assert( p &&
4940: 20 70 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e   p->pFunc && p->
4950: 70 46 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a  pFunc->xStep );.
4960: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
4970: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e  3_mutex_held(p->
4980: 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  s.db->mutex) );.
4990: 20 20 70 4d 65 6d 20 3d 20 70 2d 3e 70 4d 65 6d    pMem = p->pMem
49a0: 3b 0a 20 20 69 66 28 20 28 70 4d 65 6d 2d 3e 66  ;.  if( (pMem->f
49b0: 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67 67 29 3d  lags & MEM_Agg)=
49c0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 42  =0 ){.    if( nB
49d0: 79 74 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  yte==0 ){.      
49e0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
49f0: 6c 65 61 73 65 45 78 74 65 72 6e 61 6c 28 70 4d  leaseExternal(pM
4a00: 65 6d 29 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  em);.      pMem-
4a10: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c  >flags = MEM_Nul
4a20: 6c 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 7a  l;.      pMem->z
4a30: 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b   = 0;.    }else{
4a40: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
4a50: 62 65 4d 65 6d 47 72 6f 77 28 70 4d 65 6d 2c 20  beMemGrow(pMem, 
4a60: 6e 42 79 74 65 2c 20 30 29 3b 0a 20 20 20 20 20  nByte, 0);.     
4a70: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
4a80: 45 4d 5f 41 67 67 3b 0a 20 20 20 20 20 20 70 4d  EM_Agg;.      pM
4a90: 65 6d 2d 3e 75 2e 70 44 65 66 20 3d 20 70 2d 3e  em->u.pDef = p->
4aa0: 70 46 75 6e 63 3b 0a 20 20 20 20 20 20 69 66 28  pFunc;.      if(
4ab0: 20 70 4d 65 6d 2d 3e 7a 20 29 7b 0a 20 20 20 20   pMem->z ){.    
4ac0: 20 20 20 20 6d 65 6d 73 65 74 28 70 4d 65 6d 2d      memset(pMem-
4ad0: 3e 7a 2c 20 30 2c 20 6e 42 79 74 65 29 3b 0a 20  >z, 0, nByte);. 
4ae0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
4af0: 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a  .  return (void*
4b00: 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a  )pMem->z;.}../*.
4b10: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 75  ** Return the au
4b20: 78 69 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e  xilary data poin
4b30: 74 65 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72  ter, if any, for
4b40: 20 74 68 65 20 69 41 72 67 27 74 68 20 61 72 67   the iArg'th arg
4b50: 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20  ument to.** the 
4b60: 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65  user-function de
4b70: 66 69 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a  fined by pCtx..*
4b80: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
4b90: 67 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69  get_auxdata(sqli
4ba0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
4bb0: 78 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20  x, int iArg){.  
4bc0: 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46  VdbeFunc *pVdbeF
4bd0: 75 6e 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  unc;..  assert( 
4be0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
4bf0: 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d  ld(pCtx->s.db->m
4c00: 75 74 65 78 29 20 29 3b 0a 20 20 70 56 64 62 65  utex) );.  pVdbe
4c10: 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64  Func = pCtx->pVd
4c20: 62 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70  beFunc;.  if( !p
4c30: 56 64 62 65 46 75 6e 63 20 7c 7c 20 69 41 72 67  VdbeFunc || iArg
4c40: 3e 3d 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75  >=pVdbeFunc->nAu
4c50: 78 20 7c 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20  x || iArg<0 ){. 
4c60: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
4c70: 0a 20 20 72 65 74 75 72 6e 20 70 56 64 62 65 46  .  return pVdbeF
4c80: 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d  unc->apAux[iArg]
4c90: 2e 70 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  .pAux;.}../*.** 
4ca0: 53 65 74 20 74 68 65 20 61 75 78 69 6c 61 72 79  Set the auxilary
4cb0: 20 64 61 74 61 20 70 6f 69 6e 74 65 72 20 61 6e   data pointer an
4cc0: 64 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f  d delete functio
4cd0: 6e 2c 20 66 6f 72 20 74 68 65 20 69 41 72 67 27  n, for the iArg'
4ce0: 74 68 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74  th.** argument t
4cf0: 6f 20 74 68 65 20 75 73 65 72 2d 66 75 6e 63 74  o the user-funct
4d00: 69 6f 6e 20 64 65 66 69 6e 65 64 20 62 79 20 70  ion defined by p
4d10: 43 74 78 2e 20 41 6e 79 20 70 72 65 76 69 6f 75  Ctx. Any previou
4d20: 73 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65  s value is.** de
4d30: 6c 65 74 65 64 20 62 79 20 63 61 6c 6c 69 6e 67  leted by calling
4d40: 20 74 68 65 20 64 65 6c 65 74 65 20 66 75 6e 63   the delete func
4d50: 74 69 6f 6e 20 73 70 65 63 69 66 69 65 64 20 77  tion specified w
4d60: 68 65 6e 20 69 74 20 77 61 73 20 73 65 74 2e 0a  hen it was set..
4d70: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  */.void sqlite3_
4d80: 73 65 74 5f 61 75 78 64 61 74 61 28 0a 20 20 73  set_auxdata(.  s
4d90: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
4da0: 70 43 74 78 2c 20 0a 20 20 69 6e 74 20 69 41 72  pCtx, .  int iAr
4db0: 67 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 75 78  g, .  void *pAux
4dc0: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  , .  void (*xDel
4dd0: 65 74 65 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20  ete)(void*).){. 
4de0: 20 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20   struct AuxData 
4df0: 2a 70 41 75 78 44 61 74 61 3b 0a 20 20 56 64 62  *pAuxData;.  Vdb
4e00: 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63  eFunc *pVdbeFunc
4e10: 3b 0a 20 20 69 66 28 20 69 41 72 67 3c 30 20 29  ;.  if( iArg<0 )
4e20: 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 0a 20   goto failed;.. 
4e30: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
4e40: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78  _mutex_held(pCtx
4e50: 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29  ->s.db->mutex) )
4e60: 3b 0a 20 20 70 56 64 62 65 46 75 6e 63 20 3d 20  ;.  pVdbeFunc = 
4e70: 70 43 74 78 2d 3e 70 56 64 62 65 46 75 6e 63 3b  pCtx->pVdbeFunc;
4e80: 0a 20 20 69 66 28 20 21 70 56 64 62 65 46 75 6e  .  if( !pVdbeFun
4e90: 63 20 7c 7c 20 70 56 64 62 65 46 75 6e 63 2d 3e  c || pVdbeFunc->
4ea0: 6e 41 75 78 3c 3d 69 41 72 67 20 29 7b 0a 20 20  nAux<=iArg ){.  
4eb0: 20 20 69 6e 74 20 6e 41 75 78 20 3d 20 28 70 56    int nAux = (pV
4ec0: 64 62 65 46 75 6e 63 20 3f 20 70 56 64 62 65 46  dbeFunc ? pVdbeF
4ed0: 75 6e 63 2d 3e 6e 41 75 78 20 3a 20 30 29 3b 0a  unc->nAux : 0);.
4ee0: 20 20 20 20 69 6e 74 20 6e 4d 61 6c 6c 6f 63 20      int nMalloc 
4ef0: 3d 20 73 69 7a 65 6f 66 28 56 64 62 65 46 75 6e  = sizeof(VdbeFun
4f00: 63 29 20 2b 20 73 69 7a 65 6f 66 28 73 74 72 75  c) + sizeof(stru
4f10: 63 74 20 41 75 78 44 61 74 61 29 2a 69 41 72 67  ct AuxData)*iArg
4f20: 3b 0a 20 20 20 20 70 56 64 62 65 46 75 6e 63 20  ;.    pVdbeFunc 
4f30: 3d 20 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c  = sqlite3DbReall
4f40: 6f 63 28 70 43 74 78 2d 3e 73 2e 64 62 2c 20 70  oc(pCtx->s.db, p
4f50: 56 64 62 65 46 75 6e 63 2c 20 6e 4d 61 6c 6c 6f  VdbeFunc, nMallo
4f60: 63 29 3b 0a 20 20 20 20 69 66 28 20 21 70 56 64  c);.    if( !pVd
4f70: 62 65 46 75 6e 63 20 29 7b 0a 20 20 20 20 20 20  beFunc ){.      
4f80: 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20  goto failed;.   
4f90: 20 7d 0a 20 20 20 20 70 43 74 78 2d 3e 70 56 64   }.    pCtx->pVd
4fa0: 62 65 46 75 6e 63 20 3d 20 70 56 64 62 65 46 75  beFunc = pVdbeFu
4fb0: 6e 63 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26  nc;.    memset(&
4fc0: 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78  pVdbeFunc->apAux
4fd0: 5b 6e 41 75 78 5d 2c 20 30 2c 20 73 69 7a 65 6f  [nAux], 0, sizeo
4fe0: 66 28 73 74 72 75 63 74 20 41 75 78 44 61 74 61  f(struct AuxData
4ff0: 29 2a 28 69 41 72 67 2b 31 2d 6e 41 75 78 29 29  )*(iArg+1-nAux))
5000: 3b 0a 20 20 20 20 70 56 64 62 65 46 75 6e 63 2d  ;.    pVdbeFunc-
5010: 3e 6e 41 75 78 20 3d 20 69 41 72 67 2b 31 3b 0a  >nAux = iArg+1;.
5020: 20 20 20 20 70 56 64 62 65 46 75 6e 63 2d 3e 70      pVdbeFunc->p
5030: 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 46 75  Func = pCtx->pFu
5040: 6e 63 3b 0a 20 20 7d 0a 0a 20 20 70 41 75 78 44  nc;.  }..  pAuxD
5050: 61 74 61 20 3d 20 26 70 56 64 62 65 46 75 6e 63  ata = &pVdbeFunc
5060: 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 3b 0a 20  ->apAux[iArg];. 
5070: 20 69 66 28 20 70 41 75 78 44 61 74 61 2d 3e 70   if( pAuxData->p
5080: 41 75 78 20 26 26 20 70 41 75 78 44 61 74 61 2d  Aux && pAuxData-
5090: 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20 20 20 20  >xDelete ){.    
50a0: 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74  pAuxData->xDelet
50b0: 65 28 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78  e(pAuxData->pAux
50c0: 29 3b 0a 20 20 7d 0a 20 20 70 41 75 78 44 61 74  );.  }.  pAuxDat
50d0: 61 2d 3e 70 41 75 78 20 3d 20 70 41 75 78 3b 0a  a->pAux = pAux;.
50e0: 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c    pAuxData->xDel
50f0: 65 74 65 20 3d 20 78 44 65 6c 65 74 65 3b 0a 20  ete = xDelete;. 
5100: 20 72 65 74 75 72 6e 3b 0a 0a 66 61 69 6c 65 64   return;..failed
5110: 3a 0a 20 20 69 66 28 20 78 44 65 6c 65 74 65 20  :.  if( xDelete 
5120: 29 7b 0a 20 20 20 20 78 44 65 6c 65 74 65 28 70  ){.    xDelete(p
5130: 41 75 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66  Aux);.  }.}..#if
5140: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
5150: 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a  _DEPRECATED./*.*
5160: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
5170: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65  ber of times the
5180: 20 53 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f   Step function o
5190: 66 20 61 20 61 67 67 72 65 67 61 74 65 20 68 61  f a aggregate ha
51a0: 73 20 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65  s been .** calle
51b0: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75  d..**.** This fu
51c0: 6e 63 74 69 6f 6e 20 69 73 20 64 65 70 72 65 63  nction is deprec
51d0: 61 74 65 64 2e 20 20 44 6f 20 6e 6f 74 20 75 73  ated.  Do not us
51e0: 65 20 69 74 20 66 6f 72 20 6e 65 77 20 63 6f 64  e it for new cod
51f0: 65 2e 20 20 49 74 20 69 73 0a 2a 2a 20 70 72 6f  e.  It is.** pro
5200: 76 69 64 65 20 6f 6e 6c 79 20 74 6f 20 61 76 6f  vide only to avo
5210: 69 64 20 62 72 65 61 6b 69 6e 67 20 6c 65 67 61  id breaking lega
5220: 63 79 20 63 6f 64 65 2e 20 20 4e 65 77 20 61 67  cy code.  New ag
5230: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
5240: 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  .** implementati
5250: 6f 6e 73 20 73 68 6f 75 6c 64 20 6b 65 65 70 20  ons should keep 
5260: 74 68 65 69 72 20 6f 77 6e 20 63 6f 75 6e 74 73  their own counts
5270: 20 77 69 74 68 69 6e 20 74 68 65 69 72 20 61 67   within their ag
5280: 67 72 65 67 61 74 65 0a 2a 2a 20 63 6f 6e 74 65  gregate.** conte
5290: 78 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  xt..*/.int sqlit
52a0: 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 75  e3_aggregate_cou
52b0: 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  nt(sqlite3_conte
52c0: 78 74 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  xt *p){.  assert
52d0: 28 20 70 20 26 26 20 70 2d 3e 70 46 75 6e 63 20  ( p && p->pFunc 
52e0: 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74  && p->pFunc->xSt
52f0: 65 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  ep );.  return p
5300: 2d 3e 70 4d 65 6d 2d 3e 6e 3b 0a 7d 0a 23 65 6e  ->pMem->n;.}.#en
5310: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  dif../*.** Retur
5320: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  n the number of 
5330: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72  columns in the r
5340: 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74 68  esult set for th
5350: 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  e statement pStm
5360: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
5370: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 73  3_column_count(s
5380: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
5390: 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d  mt){.  Vdbe *pVm
53a0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
53b0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20 3f  ;.  return pVm ?
53c0: 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e   pVm->nResColumn
53d0: 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52   : 0;.}../*.** R
53e0: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
53f0: 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 6c   of values avail
5400: 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75  able from the cu
5410: 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 65  rrent row of the
5420: 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 78  .** currently ex
5430: 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 6e  ecuting statemen
5440: 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20  t pStmt..*/.int 
5450: 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75  sqlite3_data_cou
5460: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
5470: 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20  *pStmt){.  Vdbe 
5480: 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70  *pVm = (Vdbe *)p
5490: 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d  Stmt;.  if( pVm=
54a0: 3d 30 20 7c 7c 20 70 56 6d 2d 3e 70 52 65 73 75  =0 || pVm->pResu
54b0: 6c 74 53 65 74 3d 3d 30 20 29 20 72 65 74 75 72  ltSet==0 ) retur
54c0: 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56  n 0;.  return pV
54d0: 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d  m->nResColumn;.}
54e0: 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74  .../*.** Check t
54f0: 6f 20 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20  o see if column 
5500: 69 43 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65  iCol of the give
5510: 6e 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76  n statement is v
5520: 61 6c 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20  alid.  If.** it 
5530: 69 73 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69  is, return a poi
5540: 6e 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20  nter to the Mem 
5550: 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66  for the value of
5560: 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a   that column..**
5570: 20 49 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20   If iCol is not 
5580: 76 61 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20  valid, return a 
5590: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d  pointer to a Mem
55a0: 20 77 68 69 63 68 20 68 61 73 20 61 20 76 61 6c   which has a val
55b0: 75 65 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a  ue.** of NULL..*
55c0: 2f 0a 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f  /.static Mem *co
55d0: 6c 75 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f  lumnMem(sqlite3_
55e0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
55f0: 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d   i){.  Vdbe *pVm
5600: 3b 0a 20 20 69 6e 74 20 76 61 6c 73 3b 0a 20 20  ;.  int vals;.  
5610: 4d 65 6d 20 2a 70 4f 75 74 3b 0a 0a 20 20 70 56  Mem *pOut;..  pV
5620: 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  m = (Vdbe *)pStm
5630: 74 3b 0a 20 20 69 66 28 20 70 56 6d 20 26 26 20  t;.  if( pVm && 
5640: 70 56 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 21  pVm->pResultSet!
5650: 3d 30 20 26 26 20 69 3c 70 56 6d 2d 3e 6e 52 65  =0 && i<pVm->nRe
5660: 73 43 6f 6c 75 6d 6e 20 26 26 20 69 3e 3d 30 20  sColumn && i>=0 
5670: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  ){.    sqlite3_m
5680: 75 74 65 78 5f 65 6e 74 65 72 28 70 56 6d 2d 3e  utex_enter(pVm->
5690: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20  db->mutex);.    
56a0: 76 61 6c 73 20 3d 20 73 71 6c 69 74 65 33 5f 64  vals = sqlite3_d
56b0: 61 74 61 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29  ata_count(pStmt)
56c0: 3b 0a 20 20 20 20 70 4f 75 74 20 3d 20 26 70 56  ;.    pOut = &pV
56d0: 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 5b 69 5d  m->pResultSet[i]
56e0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
56f0: 74 61 74 69 63 20 63 6f 6e 73 74 20 4d 65 6d 20  tatic const Mem 
5700: 6e 75 6c 6c 4d 65 6d 20 3d 20 7b 7b 30 7d 2c 20  nullMem = {{0}, 
5710: 30 2e 30 2c 20 30 2c 20 22 22 2c 20 30 2c 20 4d  0.0, 0, "", 0, M
5720: 45 4d 5f 4e 75 6c 6c 2c 20 53 51 4c 49 54 45 5f  EM_Null, SQLITE_
5730: 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20 30 20 7d 3b  NULL, 0, 0, 0 };
5740: 0a 20 20 20 20 69 66 28 20 70 56 6d 2d 3e 64 62  .    if( pVm->db
5750: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
5760: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 56  3_mutex_enter(pV
5770: 6d 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  m->db->mutex);. 
5780: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f       sqlite3Erro
5790: 72 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54  r(pVm->db, SQLIT
57a0: 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20  E_RANGE, 0);.   
57b0: 20 7d 0a 20 20 20 20 70 4f 75 74 20 3d 20 28 4d   }.    pOut = (M
57c0: 65 6d 2a 29 26 6e 75 6c 6c 4d 65 6d 3b 0a 20 20  em*)&nullMem;.  
57d0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 4f 75 74 3b  }.  return pOut;
57e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
57f0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
5800: 64 20 61 66 74 65 72 20 69 6e 76 6f 6b 69 6e 67  d after invoking
5810: 20 61 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75   an sqlite3_valu
5820: 65 5f 58 58 58 20 66 75 6e 63 74 69 6f 6e 20 6f  e_XXX function o
5830: 6e 20 61 20 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 76  n a .** column v
5840: 61 6c 75 65 20 28 69 2e 65 2e 20 61 20 76 61 6c  alue (i.e. a val
5850: 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 65  ue returned by e
5860: 76 61 6c 75 61 74 69 6e 67 20 61 6e 20 53 51 4c  valuating an SQL
5870: 20 65 78 70 72 65 73 73 69 6f 6e 20 69 6e 20 74   expression in t
5880: 68 65 0a 2a 2a 20 73 65 6c 65 63 74 20 6c 69 73  he.** select lis
5890: 74 20 6f 66 20 61 20 53 45 4c 45 43 54 20 73 74  t of a SELECT st
58a0: 61 74 65 6d 65 6e 74 29 20 74 68 61 74 20 6d 61  atement) that ma
58b0: 79 20 63 61 75 73 65 20 61 20 6d 61 6c 6c 6f 63  y cause a malloc
58c0: 28 29 20 66 61 69 6c 75 72 65 2e 20 49 66 20 0a  () failure. If .
58d0: 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 68 61 73 20  ** malloc() has 
58e0: 66 61 69 6c 65 64 2c 20 74 68 65 20 74 68 72 65  failed, the thre
58f0: 61 64 73 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  ads mallocFailed
5900: 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 65 64   flag is cleared
5910: 20 61 6e 64 20 74 68 65 20 72 65 73 75 6c 74 0a   and the result.
5920: 2a 2a 20 63 6f 64 65 20 6f 66 20 73 74 61 74 65  ** code of state
5930: 6d 65 6e 74 20 70 53 74 6d 74 20 73 65 74 20 74  ment pStmt set t
5940: 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a  o SQLITE_NOMEM..
5950: 2a 2a 0a 2a 2a 20 53 70 65 63 69 66 69 63 61 6c  **.** Specifical
5960: 6c 79 2c 20 74 68 69 73 20 69 73 20 63 61 6c 6c  ly, this is call
5970: 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 3a 0a  ed from within:.
5980: 2a 2a 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  **.**     sqlite
5990: 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 29 0a 2a  3_column_int().*
59a0: 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f  *     sqlite3_co
59b0: 6c 75 6d 6e 5f 69 6e 74 36 34 28 29 0a 2a 2a 20  lumn_int64().** 
59c0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75      sqlite3_colu
59d0: 6d 6e 5f 74 65 78 74 28 29 0a 2a 2a 20 20 20 20  mn_text().**    
59e0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
59f0: 74 65 78 74 31 36 28 29 0a 2a 2a 20 20 20 20 20  text16().**     
5a00: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 72  sqlite3_column_r
5a10: 65 61 6c 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c  eal().**     sql
5a20: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
5a30: 73 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74  s().**     sqlit
5a40: 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31  e3_column_bytes1
5a50: 36 28 29 0a 2a 2a 0a 2a 2a 20 42 75 74 20 6e 6f  6().**.** But no
5a60: 74 20 66 6f 72 20 73 71 6c 69 74 65 33 5f 63 6f  t for sqlite3_co
5a70: 6c 75 6d 6e 5f 62 6c 6f 62 28 29 2c 20 77 68 69  lumn_blob(), whi
5a80: 63 68 20 6e 65 76 65 72 20 63 61 6c 6c 73 20 6d  ch never calls m
5a90: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 73 74 61 74  alloc()..*/.stat
5aa0: 69 63 20 76 6f 69 64 20 63 6f 6c 75 6d 6e 4d 61  ic void columnMa
5ab0: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 73 71 6c 69  llocFailure(sqli
5ac0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29  te3_stmt *pStmt)
5ad0: 0a 7b 0a 20 20 2f 2a 20 49 66 20 6d 61 6c 6c 6f  .{.  /* If mallo
5ae0: 63 28 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e  c() failed durin
5af0: 67 20 61 6e 20 65 6e 63 6f 64 69 6e 67 20 63 6f  g an encoding co
5b00: 6e 76 65 72 73 69 6f 6e 20 77 69 74 68 69 6e 20  nversion within 
5b10: 61 6e 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f  an.  ** sqlite3_
5b20: 63 6f 6c 75 6d 6e 5f 58 58 58 20 41 50 49 2c 20  column_XXX API, 
5b30: 74 68 65 6e 20 73 65 74 20 74 68 65 20 72 65 74  then set the ret
5b40: 75 72 6e 20 63 6f 64 65 20 6f 66 20 74 68 65 20  urn code of the 
5b50: 73 74 61 74 65 6d 65 6e 74 20 74 6f 0a 20 20 2a  statement to.  *
5b60: 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 20  * SQLITE_NOMEM. 
5b70: 54 68 65 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f  The next call to
5b80: 20 5f 73 74 65 70 28 29 20 28 69 66 20 61 6e 79   _step() (if any
5b90: 29 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 53 51  ) will return SQ
5ba0: 4c 49 54 45 5f 45 52 52 4f 52 0a 20 20 2a 2a 20  LITE_ERROR.  ** 
5bb0: 61 6e 64 20 5f 66 69 6e 61 6c 69 7a 65 28 29 20  and _finalize() 
5bc0: 77 69 6c 6c 20 72 65 74 75 72 6e 20 4e 4f 4d 45  will return NOME
5bd0: 4d 2e 0a 20 20 2a 2f 0a 20 20 56 64 62 65 20 2a  M..  */.  Vdbe *
5be0: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
5bf0: 74 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20  t;.  if( p ){.  
5c00: 20 20 70 2d 3e 72 63 20 3d 20 73 71 6c 69 74 65    p->rc = sqlite
5c10: 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20  3ApiExit(p->db, 
5c20: 70 2d 3e 72 63 29 3b 0a 20 20 20 20 73 71 6c 69  p->rc);.    sqli
5c30: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
5c40: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
5c50: 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a   }.}../*********
5c60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5c70: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  *** sqlite3_colu
5c80: 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  mn_  ***********
5c90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5ca0: 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ****.** The foll
5cb0: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61  owing routines a
5cc0: 72 65 20 75 73 65 64 20 74 6f 20 61 63 63 65 73  re used to acces
5cd0: 73 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68  s elements of th
5ce0: 65 20 63 75 72 72 65 6e 74 20 72 6f 77 0a 2a 2a  e current row.**
5cf0: 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73   in the result s
5d00: 65 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69  et..*/.const voi
5d10: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  d *sqlite3_colum
5d20: 6e 5f 62 6c 6f 62 28 73 71 6c 69 74 65 33 5f 73  n_blob(sqlite3_s
5d30: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
5d40: 69 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  i){.  const void
5d50: 20 2a 76 61 6c 3b 0a 20 20 76 61 6c 20 3d 20 73   *val;.  val = s
5d60: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f  qlite3_value_blo
5d70: 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  b( columnMem(pSt
5d80: 6d 74 2c 69 29 20 29 3b 0a 20 20 2f 2a 20 45 76  mt,i) );.  /* Ev
5d90: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 72 65 20  en though there 
5da0: 69 73 20 6e 6f 20 65 6e 63 6f 64 69 6e 67 20 63  is no encoding c
5db0: 6f 6e 76 65 72 73 69 6f 6e 2c 20 76 61 6c 75 65  onversion, value
5dc0: 5f 62 6c 6f 62 28 29 20 6d 69 67 68 74 0a 20 20  _blob() might.  
5dd0: 2a 2a 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20  ** need to call 
5de0: 6d 61 6c 6c 6f 63 28 29 20 74 6f 20 65 78 70 61  malloc() to expa
5df0: 6e 64 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  nd the result of
5e00: 20 61 20 7a 65 72 6f 62 6c 6f 62 28 29 20 0a 20   a zeroblob() . 
5e10: 20 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 2e 20   ** expression. 
5e20: 0a 20 20 2a 2f 0a 20 20 63 6f 6c 75 6d 6e 4d 61  .  */.  columnMa
5e30: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d  llocFailure(pStm
5e40: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c  t);.  return val
5e50: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
5e60: 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c  column_bytes(sql
5e70: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
5e80: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20  , int i){.  int 
5e90: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  val = sqlite3_va
5ea0: 6c 75 65 5f 62 79 74 65 73 28 20 63 6f 6c 75 6d  lue_bytes( colum
5eb0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
5ec0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
5ed0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
5ee0: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69   return val;.}.i
5ef0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
5f00: 6e 5f 62 79 74 65 73 31 36 28 73 71 6c 69 74 65  n_bytes16(sqlite
5f10: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
5f20: 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c  nt i){.  int val
5f30: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
5f40: 5f 62 79 74 65 73 31 36 28 20 63 6f 6c 75 6d 6e  _bytes16( column
5f50: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
5f60: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61    columnMallocFa
5f70: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20  ilure(pStmt);.  
5f80: 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 64 6f  return val;.}.do
5f90: 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c  uble sqlite3_col
5fa0: 75 6d 6e 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74  umn_double(sqlit
5fb0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
5fc0: 69 6e 74 20 69 29 7b 0a 20 20 64 6f 75 62 6c 65  int i){.  double
5fd0: 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76   val = sqlite3_v
5fe0: 61 6c 75 65 5f 64 6f 75 62 6c 65 28 20 63 6f 6c  alue_double( col
5ff0: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
6000: 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f  );.  columnMallo
6010: 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b  cFailure(pStmt);
6020: 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d  .  return val;.}
6030: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c  .int sqlite3_col
6040: 75 6d 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f  umn_int(sqlite3_
6050: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
6060: 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d   i){.  int val =
6070: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69   sqlite3_value_i
6080: 6e 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  nt( columnMem(pS
6090: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75  tmt,i) );.  colu
60a0: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28  mnMallocFailure(
60b0: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
60c0: 20 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69   val;.}.sqlite_i
60d0: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 63 6f 6c  nt64 sqlite3_col
60e0: 75 6d 6e 5f 69 6e 74 36 34 28 73 71 6c 69 74 65  umn_int64(sqlite
60f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
6100: 6e 74 20 69 29 7b 0a 20 20 73 71 6c 69 74 65 5f  nt i){.  sqlite_
6110: 69 6e 74 36 34 20 76 61 6c 20 3d 20 73 71 6c 69  int64 val = sqli
6120: 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28  te3_value_int64(
6130: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
6140: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d  ,i) );.  columnM
6150: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74  allocFailure(pSt
6160: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61  mt);.  return va
6170: 6c 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67  l;.}.const unsig
6180: 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65  ned char *sqlite
6190: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71  3_column_text(sq
61a0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
61b0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e  t, int i){.  con
61c0: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
61d0: 20 2a 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f   *val = sqlite3_
61e0: 76 61 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75  value_text( colu
61f0: 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29  mnMem(pStmt,i) )
6200: 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63  ;.  columnMalloc
6210: 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a  Failure(pStmt);.
6220: 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a    return val;.}.
6230: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 73  sqlite3_value *s
6240: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 76 61  qlite3_column_va
6250: 6c 75 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  lue(sqlite3_stmt
6260: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
6270: 0a 20 20 4d 65 6d 20 2a 70 4f 75 74 20 3d 20 63  .  Mem *pOut = c
6280: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 20  olumnMem(pStmt, 
6290: 69 29 3b 0a 20 20 69 66 28 20 70 4f 75 74 2d 3e  i);.  if( pOut->
62a0: 66 6c 61 67 73 26 4d 45 4d 5f 53 74 61 74 69 63  flags&MEM_Static
62b0: 20 29 7b 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c   ){.    pOut->fl
62c0: 61 67 73 20 26 3d 20 7e 4d 45 4d 5f 53 74 61 74  ags &= ~MEM_Stat
62d0: 69 63 3b 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c  ic;.    pOut->fl
62e0: 61 67 73 20 7c 3d 20 4d 45 4d 5f 45 70 68 65 6d  ags |= MEM_Ephem
62f0: 3b 0a 20 20 7d 0a 20 20 63 6f 6c 75 6d 6e 4d 61  ;.  }.  columnMa
6300: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d  llocFailure(pStm
6310: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 73 71  t);.  return (sq
6320: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 29 70 4f  lite3_value *)pO
6330: 75 74 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  ut;.}.#ifndef SQ
6340: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
6350: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
6360: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
6370: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
6380: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
6390: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c   const void *val
63a0: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
63b0: 5f 74 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d  _text16( columnM
63c0: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20  em(pStmt,i) );. 
63d0: 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69   columnMallocFai
63e0: 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72  lure(pStmt);.  r
63f0: 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 23 65 6e  eturn val;.}.#en
6400: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
6410: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20  IT_UTF16 */.int 
6420: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74  sqlite3_column_t
6430: 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ype(sqlite3_stmt
6440: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
6450: 0a 20 20 69 6e 74 20 69 54 79 70 65 20 3d 20 73  .  int iType = s
6460: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
6470: 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  e( columnMem(pSt
6480: 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d  mt,i) );.  colum
6490: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70  nMallocFailure(p
64a0: 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20  Stmt);.  return 
64b0: 69 54 79 70 65 3b 0a 7d 0a 0a 2f 2a 20 54 68 65  iType;.}../* The
64c0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74   following funct
64d0: 69 6f 6e 20 69 73 20 65 78 70 65 72 69 6d 65 6e  ion is experimen
64e0: 74 61 6c 20 61 6e 64 20 73 75 62 6a 65 63 74 20  tal and subject 
64f0: 74 6f 20 63 68 61 6e 67 65 20 6f 72 0a 2a 2a 20  to change or.** 
6500: 72 65 6d 6f 76 61 6c 20 2a 2f 0a 2f 2a 69 6e 74  removal */./*int
6510: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
6520: 6e 75 6d 65 72 69 63 5f 74 79 70 65 28 73 71 6c  numeric_type(sql
6530: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
6540: 2c 20 69 6e 74 20 69 29 7b 0a 2a 2a 20 20 72 65  , int i){.**  re
6550: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c  turn sqlite3_val
6560: 75 65 5f 6e 75 6d 65 72 69 63 5f 74 79 70 65 28  ue_numeric_type(
6570: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
6580: 2c 69 29 20 29 3b 0a 2a 2a 7d 0a 2a 2f 0a 0a 2f  ,i) );.**}.*/../
6590: 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 74 68 65  *.** Convert the
65a0: 20 4e 2d 74 68 20 65 6c 65 6d 65 6e 74 20 6f 66   N-th element of
65b0: 20 70 53 74 6d 74 2d 3e 70 43 6f 6c 4e 61 6d 65   pStmt->pColName
65c0: 5b 5d 20 69 6e 74 6f 20 61 20 73 74 72 69 6e 67  [] into a string
65d0: 20 75 73 69 6e 67 0a 2a 2a 20 78 46 75 6e 63 28   using.** xFunc(
65e0: 29 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68  ) then return th
65f0: 61 74 20 73 74 72 69 6e 67 2e 20 20 49 66 20 4e  at string.  If N
6600: 20 69 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65   is out of range
6610: 2c 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 0a 2a  , return 0..**.*
6620: 2a 20 54 68 65 72 65 20 61 72 65 20 75 70 20 74  * There are up t
6630: 6f 20 35 20 6e 61 6d 65 73 20 66 6f 72 20 65 61  o 5 names for ea
6640: 63 68 20 63 6f 6c 75 6d 6e 2e 20 20 75 73 65 54  ch column.  useT
6650: 79 70 65 20 64 65 74 65 72 6d 69 6e 65 73 20 77  ype determines w
6660: 68 69 63 68 0a 2a 2a 20 6e 61 6d 65 20 69 73 20  hich.** name is 
6670: 72 65 74 75 72 6e 65 64 2e 20 20 48 65 72 65 20  returned.  Here 
6680: 61 72 65 20 74 68 65 20 6e 61 6d 65 73 3a 0a 2a  are the names:.*
6690: 2a 0a 2a 2a 20 20 20 20 30 20 20 20 20 20 20 54  *.**    0      T
66a0: 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 61  he column name a
66b0: 73 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 64  s it should be d
66c0: 69 73 70 6c 61 79 65 64 20 66 6f 72 20 6f 75 74  isplayed for out
66d0: 70 75 74 0a 2a 2a 20 20 20 20 31 20 20 20 20 20  put.**    1     
66e0: 20 54 68 65 20 64 61 74 61 74 79 70 65 20 6e 61   The datatype na
66f0: 6d 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d  me for the colum
6700: 6e 0a 2a 2a 20 20 20 20 32 20 20 20 20 20 20 54  n.**    2      T
6710: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64  he name of the d
6720: 61 74 61 62 61 73 65 20 74 68 61 74 20 74 68 65  atabase that the
6730: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20   column derives 
6740: 66 72 6f 6d 0a 2a 2a 20 20 20 20 33 20 20 20 20  from.**    3    
6750: 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68    The name of th
6760: 65 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 65  e table that the
6770: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20   column derives 
6780: 66 72 6f 6d 0a 2a 2a 20 20 20 20 34 20 20 20 20  from.**    4    
6790: 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68    The name of th
67a0: 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74  e table column t
67b0: 68 61 74 20 74 68 65 20 72 65 73 75 6c 74 20 63  hat the result c
67c0: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72  olumn derives fr
67d0: 6f 6d 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  om.**.** If the 
67e0: 72 65 73 75 6c 74 20 69 73 20 6e 6f 74 20 61 20  result is not a 
67f0: 73 69 6d 70 6c 65 20 63 6f 6c 75 6d 6e 20 72 65  simple column re
6800: 66 65 72 65 6e 63 65 20 28 69 66 20 69 74 20 69  ference (if it i
6810: 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 0a  s an expression.
6820: 2a 2a 20 6f 72 20 61 20 63 6f 6e 73 74 61 6e 74  ** or a constant
6830: 29 20 74 68 65 6e 20 75 73 65 54 79 70 65 73 20  ) then useTypes 
6840: 32 2c 20 33 2c 20 61 6e 64 20 34 20 72 65 74 75  2, 3, and 4 retu
6850: 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74  rn NULL..*/.stat
6860: 69 63 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 63  ic const void *c
6870: 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 73 71 6c  olumnName(.  sql
6880: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
6890: 2c 0a 20 20 69 6e 74 20 4e 2c 0a 20 20 63 6f 6e  ,.  int N,.  con
68a0: 73 74 20 76 6f 69 64 20 2a 28 2a 78 46 75 6e 63  st void *(*xFunc
68b0: 29 28 4d 65 6d 2a 29 2c 0a 20 20 69 6e 74 20 75  )(Mem*),.  int u
68c0: 73 65 54 79 70 65 0a 29 7b 0a 20 20 63 6f 6e 73  seType.){.  cons
68d0: 74 20 76 6f 69 64 20 2a 72 65 74 20 3d 20 30 3b  t void *ret = 0;
68e0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
68f0: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e  be *)pStmt;.  in
6900: 74 20 6e 3b 0a 20 20 0a 0a 20 20 69 66 28 20 70  t n;.  ..  if( p
6910: 21 3d 30 20 29 7b 0a 20 20 20 20 6e 20 3d 20 73  !=0 ){.    n = s
6920: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
6930: 75 6e 74 28 70 53 74 6d 74 29 3b 0a 20 20 20 20  unt(pStmt);.    
6940: 69 66 28 20 4e 3c 6e 20 26 26 20 4e 3e 3d 30 20  if( N<n && N>=0 
6950: 29 7b 0a 20 20 20 20 20 20 4e 20 2b 3d 20 75 73  ){.      N += us
6960: 65 54 79 70 65 2a 6e 3b 0a 20 20 20 20 20 20 73  eType*n;.      s
6970: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
6980: 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  er(p->db->mutex)
6990: 3b 0a 20 20 20 20 20 20 72 65 74 20 3d 20 78 46  ;.      ret = xF
69a0: 75 6e 63 28 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65  unc(&p->aColName
69b0: 5b 4e 5d 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20  [N]);..      /* 
69c0: 41 20 6d 61 6c 6c 6f 63 20 6d 61 79 20 68 61 76  A malloc may hav
69d0: 65 20 66 61 69 6c 65 64 20 69 6e 73 69 64 65 20  e failed inside 
69e0: 6f 66 20 74 68 65 20 78 46 75 6e 63 28 29 20 63  of the xFunc() c
69f0: 61 6c 6c 2e 20 49 66 20 74 68 69 73 0a 20 20 20  all. If this.   
6a00: 20 20 20 2a 2a 20 69 73 20 74 68 65 20 63 61 73     ** is the cas
6a10: 65 2c 20 63 6c 65 61 72 20 74 68 65 20 6d 61 6c  e, clear the mal
6a20: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 61  locFailed flag a
6a30: 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a  nd return NULL..
6a40: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69        */.      i
6a50: 66 28 20 70 2d 3e 64 62 20 26 26 20 70 2d 3e 64  f( p->db && p->d
6a60: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
6a70: 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 64 62  ){.        p->db
6a80: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d  ->mallocFailed =
6a90: 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 20   0;.        ret 
6aa0: 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  = 0;.      }.   
6ab0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
6ac0: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75  _leave(p->db->mu
6ad0: 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  tex);.    }.  }.
6ae0: 20 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a    return ret;.}.
6af0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
6b00: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e 74  e name of the Nt
6b10: 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20  h column of the 
6b20: 72 65 73 75 6c 74 20 73 65 74 20 72 65 74 75 72  result set retur
6b30: 6e 65 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74  ned by SQL.** st
6b40: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a  atement pStmt..*
6b50: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
6b60: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d  lite3_column_nam
6b70: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
6b80: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
6b90: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
6ba0: 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c  me(.      pStmt,
6bb0: 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a   N, (const void*
6bc0: 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65  (*)(Mem*))sqlite
6bd0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f  3_value_text, CO
6be0: 4c 4e 41 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23  LNAME_NAME);.}.#
6bf0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
6c00: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76  IT_UTF16.const v
6c10: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  oid *sqlite3_col
6c20: 75 6d 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74  umn_name16(sqlit
6c30: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
6c40: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
6c50: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20   columnName(.   
6c60: 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f     pStmt, N, (co
6c70: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
6c80: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
6c90: 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45  _text16, COLNAME
6ca0: 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 65 6e 64 69 66  _NAME);.}.#endif
6cb0: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 72 61 69  ../*.** Constrai
6cc0: 6e 74 3a 20 20 49 66 20 79 6f 75 20 68 61 76 65  nt:  If you have
6cd0: 20 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d   ENABLE_COLUMN_M
6ce0: 45 54 41 44 41 54 41 20 74 68 65 6e 20 79 6f 75  ETADATA then you
6cf0: 20 6d 75 73 74 0a 2a 2a 20 6e 6f 74 20 64 65 66   must.** not def
6d00: 69 6e 65 20 4f 4d 49 54 5f 44 45 43 4c 54 59 50  ine OMIT_DECLTYP
6d10: 45 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65  E..*/.#if define
6d20: 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45  d(SQLITE_OMIT_DE
6d30: 43 4c 54 59 50 45 29 20 26 26 20 64 65 66 69 6e  CLTYPE) && defin
6d40: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ed(SQLITE_ENABLE
6d50: 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41  _COLUMN_METADATA
6d60: 29 0a 23 20 65 72 72 6f 72 20 22 4d 75 73 74 20  ).# error "Must 
6d70: 6e 6f 74 20 64 65 66 69 6e 65 20 62 6f 74 68 20  not define both 
6d80: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c  SQLITE_OMIT_DECL
6d90: 54 59 50 45 20 5c 0a 20 20 20 20 20 20 20 20 20  TYPE \.         
6da0: 61 6e 64 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  and SQLITE_ENABL
6db0: 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54  E_COLUMN_METADAT
6dc0: 41 22 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64  A".#endif..#ifnd
6dd0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44  ef SQLITE_OMIT_D
6de0: 45 43 4c 54 59 50 45 0a 2f 2a 0a 2a 2a 20 52 65  ECLTYPE./*.** Re
6df0: 74 75 72 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20  turn the column 
6e00: 64 65 63 6c 61 72 61 74 69 6f 6e 20 74 79 70 65  declaration type
6e10: 20 28 69 66 20 61 70 70 6c 69 63 61 62 6c 65 29   (if applicable)
6e20: 20 6f 66 20 74 68 65 20 27 69 27 74 68 20 63 6f   of the 'i'th co
6e30: 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72  lumn.** of the r
6e40: 65 73 75 6c 74 20 73 65 74 20 6f 66 20 53 51 4c  esult set of SQL
6e50: 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74   statement pStmt
6e60: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  ..*/.const char 
6e70: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
6e80: 64 65 63 6c 74 79 70 65 28 73 71 6c 69 74 65 33  decltype(sqlite3
6e90: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
6ea0: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63  t N){.  return c
6eb0: 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20  olumnName(.     
6ec0: 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73   pStmt, N, (cons
6ed0: 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29  t void*(*)(Mem*)
6ee0: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  )sqlite3_value_t
6ef0: 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 43  ext, COLNAME_DEC
6f00: 4c 54 59 50 45 29 3b 0a 7d 0a 23 69 66 6e 64 65  LTYPE);.}.#ifnde
6f10: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  f SQLITE_OMIT_UT
6f20: 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a  F16.const void *
6f30: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
6f40: 65 63 6c 74 79 70 65 31 36 28 73 71 6c 69 74 65  ecltype16(sqlite
6f50: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
6f60: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt N){.  return 
6f70: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20  columnName(.    
6f80: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e    pStmt, N, (con
6f90: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a  st void*(*)(Mem*
6fa0: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ))sqlite3_value_
6fb0: 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f  text16, COLNAME_
6fc0: 44 45 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 65 6e  DECLTYPE);.}.#en
6fd0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
6fe0: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64  IT_UTF16 */.#end
6ff0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
7000: 54 5f 44 45 43 4c 54 59 50 45 20 2a 2f 0a 0a 23  T_DECLTYPE */..#
7010: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
7020: 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44  BLE_COLUMN_METAD
7030: 41 54 41 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  ATA./*.** Return
7040: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
7050: 20 64 61 74 61 62 61 73 65 20 66 72 6f 6d 20 77   database from w
7060: 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f  hich a result co
7070: 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a  lumn derives..**
7080: 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65   NULL is returne
7090: 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20  d if the result 
70a0: 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70  column is an exp
70b0: 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74  ression or const
70c0: 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69  ant or.** anythi
70d0: 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 73  ng else which is
70e0: 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f   not an unabiguo
70f0: 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20  us reference to 
7100: 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d  a database colum
7110: 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72  n..*/.const char
7120: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
7130: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 28 73  _database_name(s
7140: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
7150: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  mt, int N){.  re
7160: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28  turn columnName(
7170: 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c  .      pStmt, N,
7180: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29   (const void*(*)
7190: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76  (Mem*))sqlite3_v
71a0: 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41  alue_text, COLNA
71b0: 4d 45 5f 44 41 54 41 42 41 53 45 29 3b 0a 7d 0a  ME_DATABASE);.}.
71c0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
71d0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
71e0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
71f0: 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61  lumn_database_na
7200: 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d  me16(sqlite3_stm
7210: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
7220: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
7230: 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74  nName(.      pSt
7240: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f  mt, N, (const vo
7250: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c  id*(*)(Mem*))sql
7260: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
7270: 36 2c 20 43 4f 4c 4e 41 4d 45 5f 44 41 54 41 42  6, COLNAME_DATAB
7280: 41 53 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  ASE);.}.#endif /
7290: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
72a0: 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65  F16 */../*.** Re
72b0: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
72c0: 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d 20   the table from 
72d0: 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63  which a result c
72e0: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a  olumn derives..*
72f0: 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e  * NULL is return
7300: 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74  ed if the result
7310: 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78   column is an ex
7320: 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73  pression or cons
7330: 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68  tant or.** anyth
7340: 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69  ing else which i
7350: 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75  s not an unabigu
7360: 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f  ous reference to
7370: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75   a database colu
7380: 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  mn..*/.const cha
7390: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  r *sqlite3_colum
73a0: 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28 73 71 6c  n_table_name(sql
73b0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
73c0: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
73d0: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20  rn columnName(. 
73e0: 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28       pStmt, N, (
73f0: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
7400: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
7410: 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45  ue_text, COLNAME
7420: 5f 54 41 42 4c 45 29 3b 0a 7d 0a 23 69 66 6e 64  _TABLE);.}.#ifnd
7430: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  ef SQLITE_OMIT_U
7440: 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20  TF16.const void 
7450: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
7460: 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c  table_name16(sql
7470: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
7480: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
7490: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20  rn columnName(. 
74a0: 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28       pStmt, N, (
74b0: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
74c0: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
74d0: 75 65 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41  ue_text16, COLNA
74e0: 4d 45 5f 54 41 42 4c 45 29 3b 0a 7d 0a 23 65 6e  ME_TABLE);.}.#en
74f0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
7500: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a  IT_UTF16 */../*.
7510: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61  ** Return the na
7520: 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  me of the table 
7530: 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 77 68 69 63  column from whic
7540: 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d  h a result colum
7550: 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55  n derives..** NU
7560: 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 69  LL is returned i
7570: 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c  f the result col
7580: 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73  umn is an expres
7590: 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74  sion or constant
75a0: 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20   or.** anything 
75b0: 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f  else which is no
75c0: 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20  t an unabiguous 
75d0: 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64  reference to a d
75e0: 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a  atabase column..
75f0: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
7600: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72  qlite3_column_or
7610: 69 67 69 6e 5f 6e 61 6d 65 28 73 71 6c 69 74 65  igin_name(sqlite
7620: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
7630: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt N){.  return 
7640: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20  columnName(.    
7650: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e    pStmt, N, (con
7660: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a  st void*(*)(Mem*
7670: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ))sqlite3_value_
7680: 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 43 4f  text, COLNAME_CO
7690: 4c 55 4d 4e 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  LUMN);.}.#ifndef
76a0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
76b0: 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73  16.const void *s
76c0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72  qlite3_column_or
76d0: 69 67 69 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69  igin_name16(sqli
76e0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
76f0: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
7700: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20  n columnName(.  
7710: 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63      pStmt, N, (c
7720: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65  onst void*(*)(Me
7730: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  m*))sqlite3_valu
7740: 65 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d  e_text16, COLNAM
7750: 45 5f 43 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23 65 6e  E_COLUMN);.}.#en
7760: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
7770: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64  IT_UTF16 */.#end
7780: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
7790: 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44  BLE_COLUMN_METAD
77a0: 41 54 41 20 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a  ATA */.../******
77b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
77c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65  ********* sqlite
77d0: 33 5f 62 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a  3_bind_  *******
77e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
77f0: 2a 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74  ****.** .** Rout
7800: 69 6e 65 73 20 75 73 65 64 20 74 6f 20 61 74 74  ines used to att
7810: 61 63 68 20 76 61 6c 75 65 73 20 74 6f 20 77 69  ach values to wi
7820: 6c 64 63 61 72 64 73 20 69 6e 20 61 20 63 6f 6d  ldcards in a com
7830: 70 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d  piled SQL statem
7840: 65 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e  ent..*/./*.** Un
7850: 62 69 6e 64 20 74 68 65 20 76 61 6c 75 65 20 62  bind the value b
7860: 6f 75 6e 64 20 74 6f 20 76 61 72 69 61 62 6c 65  ound to variable
7870: 20 69 20 69 6e 20 76 69 72 74 75 61 6c 20 6d 61   i in virtual ma
7880: 63 68 69 6e 65 20 70 2e 20 54 68 69 73 20 69 73  chine p. This is
7890: 20 74 68 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d   the .** the sam
78a0: 65 20 61 73 20 62 69 6e 64 69 6e 67 20 61 20 4e  e as binding a N
78b0: 55 4c 4c 20 76 61 6c 75 65 20 74 6f 20 74 68 65  ULL value to the
78c0: 20 63 6f 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20   column. If the 
78d0: 22 69 22 20 70 61 72 61 6d 65 74 65 72 20 69 73  "i" parameter is
78e0: 0a 2a 2a 20 6f 75 74 20 6f 66 20 72 61 6e 67 65  .** out of range
78f0: 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 52 41  , then SQLITE_RA
7900: 4e 47 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e  NGE is returned.
7910: 20 4f 74 68 65 77 69 73 65 20 53 51 4c 49 54 45   Othewise SQLITE
7920: 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 75 63  _OK..**.** A suc
7930: 63 65 73 73 66 75 6c 20 65 76 61 6c 75 61 74 69  cessful evaluati
7940: 6f 6e 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69  on of this routi
7950: 6e 65 20 61 63 71 75 69 72 65 73 20 74 68 65 20  ne acquires the 
7960: 6d 75 74 65 78 20 6f 6e 20 70 2e 0a 2a 2a 20 74  mutex on p..** t
7970: 68 65 20 6d 75 74 65 78 20 69 73 20 72 65 6c 65  he mutex is rele
7980: 61 73 65 64 20 69 66 20 61 6e 79 20 6b 69 6e 64  ased if any kind
7990: 20 6f 66 20 65 72 72 6f 72 20 6f 63 63 75 72 73   of error occurs
79a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 72 72 6f  ..**.** The erro
79b0: 72 20 63 6f 64 65 20 73 74 6f 72 65 64 20 69 6e  r code stored in
79c0: 20 64 61 74 61 62 61 73 65 20 70 2d 3e 64 62 20   database p->db 
79d0: 69 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77  is overwritten w
79e0: 69 74 68 20 74 68 65 20 72 65 74 75 72 6e 0a 2a  ith the return.*
79f0: 2a 20 76 61 6c 75 65 20 69 6e 20 61 6e 79 20 63  * value in any c
7a00: 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ase..*/.static i
7a10: 6e 74 20 76 64 62 65 55 6e 62 69 6e 64 28 56 64  nt vdbeUnbind(Vd
7a20: 62 65 20 2a 70 2c 20 69 6e 74 20 69 29 7b 0a 20  be *p, int i){. 
7a30: 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 69 66   Mem *pVar;.  if
7a40: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  ( p==0 ) return 
7a50: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20  SQLITE_MISUSE;. 
7a60: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
7a70: 6e 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65  nter(p->db->mute
7a80: 78 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67  x);.  if( p->mag
7a90: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic!=VDBE_MAGIC_R
7aa0: 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30 20 29  UN || p->pc>=0 )
7ab0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72  {.    sqlite3Err
7ac0: 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45  or(p->db, SQLITE
7ad0: 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a 20 20 20  _MISUSE, 0);.   
7ae0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
7af0: 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65  eave(p->db->mute
7b00: 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  x);.    return S
7b10: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
7b20: 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c 7c 20 69  }.  if( i<1 || i
7b30: 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20  >p->nVar ){.    
7b40: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e  sqlite3Error(p->
7b50: 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  db, SQLITE_RANGE
7b60: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
7b70: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d  3_mutex_leave(p-
7b80: 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20  >db->mutex);.   
7b90: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52   return SQLITE_R
7ba0: 41 4e 47 45 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b  ANGE;.  }.  i--;
7bb0: 0a 20 20 70 56 61 72 20 3d 20 26 70 2d 3e 61 56  .  pVar = &p->aV
7bc0: 61 72 5b 69 5d 3b 0a 20 20 73 71 6c 69 74 65 33  ar[i];.  sqlite3
7bd0: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 70  VdbeMemRelease(p
7be0: 56 61 72 29 3b 0a 20 20 70 56 61 72 2d 3e 66 6c  Var);.  pVar->fl
7bf0: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a  ags = MEM_Null;.
7c00: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70    sqlite3Error(p
7c10: 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c  ->db, SQLITE_OK,
7c20: 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51   0);.  return SQ
7c30: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
7c40: 2a 20 42 69 6e 64 20 61 20 74 65 78 74 20 6f 72  * Bind a text or
7c50: 20 42 4c 4f 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a   BLOB value..*/.
7c60: 73 74 61 74 69 63 20 69 6e 74 20 62 69 6e 64 54  static int bindT
7c70: 65 78 74 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  ext(.  sqlite3_s
7c80: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 20 20 2f 2a  tmt *pStmt,   /*
7c90: 20 54 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74   The statement t
7ca0: 6f 20 62 69 6e 64 20 61 67 61 69 6e 73 74 20 2a  o bind against *
7cb0: 2f 0a 20 20 69 6e 74 20 69 2c 20 20 20 20 20 20  /.  int i,      
7cc0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e             /* In
7cd0: 64 65 78 20 6f 66 20 74 68 65 20 70 61 72 61 6d  dex of the param
7ce0: 65 74 65 72 20 74 6f 20 62 69 6e 64 20 2a 2f 0a  eter to bind */.
7cf0: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44    const void *zD
7d00: 61 74 61 2c 20 20 20 20 20 2f 2a 20 50 6f 69 6e  ata,     /* Poin
7d10: 74 65 72 20 74 6f 20 74 68 65 20 64 61 74 61 20  ter to the data 
7d20: 74 6f 20 62 65 20 62 6f 75 6e 64 20 2a 2f 0a 20  to be bound */. 
7d30: 20 69 6e 74 20 6e 44 61 74 61 2c 20 20 20 20 20   int nData,     
7d40: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
7d50: 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 64 61  r of bytes of da
7d60: 74 61 20 74 6f 20 62 65 20 62 6f 75 6e 64 20 2a  ta to be bound *
7d70: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29  /.  void (*xDel)
7d80: 28 76 6f 69 64 2a 29 2c 20 20 20 2f 2a 20 44 65  (void*),   /* De
7d90: 73 74 72 75 63 74 6f 72 20 66 6f 72 20 74 68 65  structor for the
7da0: 20 64 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 65   data */.  int e
7db0: 6e 63 6f 64 69 6e 67 20 20 20 20 20 20 20 20 20  ncoding         
7dc0: 20 20 2f 2a 20 45 6e 63 6f 64 69 6e 67 20 66 6f    /* Encoding fo
7dd0: 72 20 74 68 65 20 64 61 74 61 20 2a 2f 0a 29 7b  r the data */.){
7de0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
7df0: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65  be *)pStmt;.  Me
7e00: 6d 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72  m *pVar;.  int r
7e10: 63 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55  c;..  rc = vdbeU
7e20: 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69  nbind(p, i);.  i
7e30: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
7e40: 20 29 7b 0a 20 20 20 20 69 66 28 20 7a 44 61 74   ){.    if( zDat
7e50: 61 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 56  a!=0 ){.      pV
7e60: 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 2d  ar = &p->aVar[i-
7e70: 31 5d 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73  1];.      rc = s
7e80: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
7e90: 53 74 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c  Str(pVar, zData,
7ea0: 20 6e 44 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67   nData, encoding
7eb0: 2c 20 78 44 65 6c 29 3b 0a 20 20 20 20 20 20 69  , xDel);.      i
7ec0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
7ed0: 20 26 26 20 65 6e 63 6f 64 69 6e 67 21 3d 30 20   && encoding!=0 
7ee0: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  ){.        rc = 
7ef0: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
7f00: 65 45 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20  eEncoding(pVar, 
7f10: 45 4e 43 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20  ENC(p->db));.   
7f20: 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74     }.      sqlit
7f30: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72  e3Error(p->db, r
7f40: 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 72 63 20  c, 0);.      rc 
7f50: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  = sqlite3ApiExit
7f60: 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 20  (p->db, rc);.   
7f70: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d   }.    sqlite3_m
7f80: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62  utex_leave(p->db
7f90: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20  ->mutex);.  }.  
7fa0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f  return rc;.}.../
7fb0: 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 62 6c 6f 62  *.** Bind a blob
7fc0: 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 53 51 4c   value to an SQL
7fd0: 20 73 74 61 74 65 6d 65 6e 74 20 76 61 72 69 61   statement varia
7fe0: 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ble..*/.int sqli
7ff0: 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a 20  te3_bind_blob(. 
8000: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
8010: 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20  Stmt, .  int i, 
8020: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
8030: 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44 61  Data, .  int nDa
8040: 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44  ta, .  void (*xD
8050: 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20  el)(void*).){.  
8060: 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28  return bindText(
8070: 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c  pStmt, i, zData,
8080: 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29   nData, xDel, 0)
8090: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
80a0: 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73 71 6c 69  bind_double(sqli
80b0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
80c0: 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c 65 20 72   int i, double r
80d0: 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63  Value){.  int rc
80e0: 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  ;.  Vdbe *p = (V
80f0: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72  dbe *)pStmt;.  r
8100: 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70  c = vdbeUnbind(p
8110: 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d  , i);.  if( rc==
8120: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
8130: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
8140: 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e 61 56 61  etDouble(&p->aVa
8150: 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75 65 29 3b  r[i-1], rValue);
8160: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
8170: 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e  ex_leave(p->db->
8180: 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65  mutex);.  }.  re
8190: 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73  turn rc;.}.int s
81a0: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 28  qlite3_bind_int(
81b0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 2c  sqlite3_stmt *p,
81c0: 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 56 61 6c   int i, int iVal
81d0: 75 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  ue){.  return sq
81e0: 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34  lite3_bind_int64
81f0: 28 70 2c 20 69 2c 20 28 69 36 34 29 69 56 61 6c  (p, i, (i64)iVal
8200: 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74  ue);.}.int sqlit
8210: 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 73 71  e3_bind_int64(sq
8220: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
8230: 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69 74 65  t, int i, sqlite
8240: 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 29 7b 0a  _int64 iValue){.
8250: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65    int rc;.  Vdbe
8260: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
8270: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65  tmt;.  rc = vdbe
8280: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20  Unbind(p, i);.  
8290: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
82a0: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
82b0: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28  VdbeMemSetInt64(
82c0: 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 69  &p->aVar[i-1], i
82d0: 56 61 6c 75 65 29 3b 0a 20 20 20 20 73 71 6c 69  Value);.    sqli
82e0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
82f0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
8300: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
8310: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  }.int sqlite3_bi
8320: 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f  nd_null(sqlite3_
8330: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
8340: 20 69 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20   i){.  int rc;. 
8350: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
8360: 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20  *)pStmt;.  rc = 
8370: 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29  vdbeUnbind(p, i)
8380: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ;.  if( rc==SQLI
8390: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
83a0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
83b0: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
83c0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
83d0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  .}.int sqlite3_b
83e0: 69 6e 64 5f 74 65 78 74 28 20 0a 20 20 73 71 6c  ind_text( .  sql
83f0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
8400: 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63  , .  int i, .  c
8410: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 61 74 61  onst char *zData
8420: 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20  , .  int nData, 
8430: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
8440: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75  void*).){.  retu
8450: 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d  rn bindText(pStm
8460: 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61  t, i, zData, nDa
8470: 74 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45  ta, xDel, SQLITE
8480: 5f 55 54 46 38 29 3b 0a 7d 0a 23 69 66 6e 64 65  _UTF8);.}.#ifnde
8490: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  f SQLITE_OMIT_UT
84a0: 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  F16.int sqlite3_
84b0: 62 69 6e 64 5f 74 65 78 74 31 36 28 0a 20 20 73  bind_text16(.  s
84c0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
84d0: 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20  mt, .  int i, . 
84e0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61   const void *zDa
84f0: 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61  ta, .  int nData
8500: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  , .  void (*xDel
8510: 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65  )(void*).){.  re
8520: 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53  turn bindText(pS
8530: 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e  tmt, i, zData, n
8540: 44 61 74 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49  Data, xDel, SQLI
8550: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b  TE_UTF16NATIVE);
8560: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
8570: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a  ITE_OMIT_UTF16 *
8580: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  /.int sqlite3_bi
8590: 6e 64 5f 76 61 6c 75 65 28 73 71 6c 69 74 65 33  nd_value(sqlite3
85a0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
85b0: 74 20 69 2c 20 63 6f 6e 73 74 20 73 71 6c 69 74  t i, const sqlit
85c0: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 75 65  e3_value *pValue
85d0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56  ){.  int rc;.  V
85e0: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a  dbe *p = (Vdbe *
85f0: 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76  )pStmt;.  rc = v
8600: 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b  dbeUnbind(p, i);
8610: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
8620: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d  E_OK ){.    rc =
8630: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43   sqlite3VdbeMemC
8640: 6f 70 79 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31  opy(&p->aVar[i-1
8650: 5d 2c 20 70 56 61 6c 75 65 29 3b 0a 20 20 20 20  ], pValue);.    
8660: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
8670: 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  K ){.      rc = 
8680: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
8690: 65 45 6e 63 6f 64 69 6e 67 28 26 70 2d 3e 61 56  eEncoding(&p->aV
86a0: 61 72 5b 69 2d 31 5d 2c 20 45 4e 43 28 70 2d 3e  ar[i-1], ENC(p->
86b0: 64 62 29 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  db));.    }.    
86c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
86d0: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ave(p->db->mutex
86e0: 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71  );.  }.  rc = sq
86f0: 6c 69 74 65 33 41 70 69 45 78 69 74 28 70 2d 3e  lite3ApiExit(p->
8700: 64 62 2c 20 72 63 29 3b 0a 20 20 72 65 74 75 72  db, rc);.  retur
8710: 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  n rc;.}.int sqli
8720: 74 65 33 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f  te3_bind_zeroblo
8730: 62 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  b(sqlite3_stmt *
8740: 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 69 6e  pStmt, int i, in
8750: 74 20 6e 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  t n){.  int rc;.
8760: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
8770: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20  e *)pStmt;.  rc 
8780: 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20  = vdbeUnbind(p, 
8790: 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  i);.  if( rc==SQ
87a0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73  LITE_OK ){.    s
87b0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
87c0: 5a 65 72 6f 42 6c 6f 62 28 26 70 2d 3e 61 56 61  ZeroBlob(&p->aVa
87d0: 72 5b 69 2d 31 5d 2c 20 6e 29 3b 0a 20 20 20 20  r[i-1], n);.    
87e0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
87f0: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ave(p->db->mutex
8800: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
8810: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  rc;.}../*.** Ret
8820: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
8830: 66 20 77 69 6c 64 63 61 72 64 73 20 74 68 61 74  f wildcards that
8840: 20 63 61 6e 20 62 65 20 70 6f 74 65 6e 74 69 61   can be potentia
8850: 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e 0a 2a 2a  lly bound to..**
8860: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
8870: 20 61 64 64 65 64 20 74 6f 20 73 75 70 70 6f 72   added to suppor
8880: 74 20 44 42 44 3a 3a 53 51 4c 69 74 65 2e 20 20  t DBD::SQLite.  
8890: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
88a0: 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f 63  bind_parameter_c
88b0: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  ount(sqlite3_stm
88c0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
88d0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
88e0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 20  tmt;.  return p 
88f0: 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30 3b 0a 7d  ? p->nVar : 0;.}
8900: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61  ../*.** Create a
8910: 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20 76 61   mapping from va
8920: 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 73 20 74  riable numbers t
8930: 6f 20 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 73  o variable names
8940: 0a 2a 2a 20 69 6e 20 74 68 65 20 56 64 62 65 2e  .** in the Vdbe.
8950: 61 7a 56 61 72 5b 5d 20 61 72 72 61 79 2c 20 69  azVar[] array, i
8960: 66 20 73 75 63 68 20 61 20 6d 61 70 70 69 6e 67  f such a mapping
8970: 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65 61 64   does not alread
8980: 79 0a 2a 2a 20 65 78 69 73 74 2e 0a 2a 2f 0a 73  y.** exist..*/.s
8990: 74 61 74 69 63 20 76 6f 69 64 20 63 72 65 61 74  tatic void creat
89a0: 65 56 61 72 4d 61 70 28 56 64 62 65 20 2a 70 29  eVarMap(Vdbe *p)
89b0: 7b 0a 20 20 69 66 28 20 21 70 2d 3e 6f 6b 56 61  {.  if( !p->okVa
89c0: 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  r ){.    sqlite3
89d0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e  _mutex_enter(p->
89e0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20  db->mutex);.    
89f0: 69 66 28 20 21 70 2d 3e 6f 6b 56 61 72 20 29 7b  if( !p->okVar ){
8a00: 0a 20 20 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20  .      int j;.  
8a10: 20 20 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20 20      Op *pOp;.   
8a20: 20 20 20 66 6f 72 28 6a 3d 30 2c 20 70 4f 70 3d     for(j=0, pOp=
8a30: 70 2d 3e 61 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f 70  p->aOp; j<p->nOp
8a40: 3b 20 6a 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20  ; j++, pOp++){. 
8a50: 20 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e         if( pOp->
8a60: 6f 70 63 6f 64 65 3d 3d 4f 50 5f 56 61 72 69 61  opcode==OP_Varia
8a70: 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20  ble ){.         
8a80: 20 61 73 73 65 72 74 28 20 70 4f 70 2d 3e 70 31   assert( pOp->p1
8a90: 3e 30 20 26 26 20 70 4f 70 2d 3e 70 31 3c 3d 70  >0 && pOp->p1<=p
8aa0: 2d 3e 6e 56 61 72 20 29 3b 0a 20 20 20 20 20 20  ->nVar );.      
8ab0: 20 20 20 20 70 2d 3e 61 7a 56 61 72 5b 70 4f 70      p->azVar[pOp
8ac0: 2d 3e 70 31 2d 31 5d 20 3d 20 70 4f 70 2d 3e 70  ->p1-1] = pOp->p
8ad0: 34 2e 7a 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  4.z;.        }. 
8ae0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 2d 3e       }.      p->
8af0: 6f 6b 56 61 72 20 3d 20 31 3b 0a 20 20 20 20 7d  okVar = 1;.    }
8b00: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
8b10: 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e  ex_leave(p->db->
8b20: 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  mutex);.  }.}../
8b30: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
8b40: 6e 61 6d 65 20 6f 66 20 61 20 77 69 6c 64 63 61  name of a wildca
8b50: 72 64 20 70 61 72 61 6d 65 74 65 72 2e 20 20 52  rd parameter.  R
8b60: 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68  eturn NULL if th
8b70: 65 20 69 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75  e index.** is ou
8b80: 74 20 6f 66 20 72 61 6e 67 65 20 6f 72 20 69 66  t of range or if
8b90: 20 74 68 65 20 77 69 6c 64 63 61 72 64 20 69 73   the wildcard is
8ba0: 20 75 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20   unnamed..**.** 
8bb0: 54 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 6c  The result is al
8bc0: 77 61 79 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63  ways UTF-8..*/.c
8bd0: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
8be0: 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65  e3_bind_paramete
8bf0: 72 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73  r_name(sqlite3_s
8c00: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
8c10: 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  i){.  Vdbe *p = 
8c20: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
8c30: 69 66 28 20 70 3d 3d 30 20 7c 7c 20 69 3c 31 20  if( p==0 || i<1 
8c40: 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a  || i>p->nVar ){.
8c50: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
8c60: 7d 0a 20 20 63 72 65 61 74 65 56 61 72 4d 61 70  }.  createVarMap
8c70: 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d  (p);.  return p-
8c80: 3e 61 7a 56 61 72 5b 69 2d 31 5d 3b 0a 7d 0a 0a  >azVar[i-1];.}..
8c90: 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20 77 69  /*.** Given a wi
8ca0: 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74 65 72  ldcard parameter
8cb0: 20 6e 61 6d 65 2c 20 72 65 74 75 72 6e 20 74 68   name, return th
8cc0: 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65 20 76  e index of the v
8cd0: 61 72 69 61 62 6c 65 0a 2a 2a 20 77 69 74 68 20  ariable.** with 
8ce0: 74 68 61 74 20 6e 61 6d 65 2e 20 20 49 66 20 74  that name.  If t
8cf0: 68 65 72 65 20 69 73 20 6e 6f 20 76 61 72 69 61  here is no varia
8d00: 62 6c 65 20 77 69 74 68 20 74 68 65 20 67 69 76  ble with the giv
8d10: 65 6e 20 6e 61 6d 65 2c 0a 2a 2a 20 72 65 74 75  en name,.** retu
8d20: 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  rn 0..*/.int sql
8d30: 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65  ite3_bind_parame
8d40: 74 65 72 5f 69 6e 64 65 78 28 73 71 6c 69 74 65  ter_index(sqlite
8d50: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 63  3_stmt *pStmt, c
8d60: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65  onst char *zName
8d70: 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  ){.  Vdbe *p = (
8d80: 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69  Vdbe*)pStmt;.  i
8d90: 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30  nt i;.  if( p==0
8da0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
8db0: 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65 56 61  ;.  }.  createVa
8dc0: 72 4d 61 70 28 70 29 3b 20 0a 20 20 69 66 28 20  rMap(p); .  if( 
8dd0: 7a 4e 61 6d 65 20 29 7b 0a 20 20 20 20 66 6f 72  zName ){.    for
8de0: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b  (i=0; i<p->nVar;
8df0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 63 6f 6e   i++){.      con
8e00: 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 70 2d 3e  st char *z = p->
8e10: 61 7a 56 61 72 5b 69 5d 3b 0a 20 20 20 20 20 20  azVar[i];.      
8e20: 69 66 28 20 7a 20 26 26 20 73 74 72 63 6d 70 28  if( z && strcmp(
8e30: 7a 2c 7a 4e 61 6d 65 29 3d 3d 30 20 29 7b 0a 20  z,zName)==0 ){. 
8e40: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 69 2b         return i+
8e50: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  1;.      }.    }
8e60: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
8e70: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 61 6e 73 66  .}../*.** Transf
8e80: 65 72 20 61 6c 6c 20 62 69 6e 64 69 6e 67 73 20  er all bindings 
8e90: 66 72 6f 6d 20 74 68 65 20 66 69 72 73 74 20 73  from the first s
8ea0: 74 61 74 65 6d 65 6e 74 20 6f 76 65 72 20 74 6f  tatement over to
8eb0: 20 74 68 65 20 73 65 63 6f 6e 64 2e 0a 2a 2a 20   the second..** 
8ec0: 49 66 20 74 68 65 20 74 77 6f 20 73 74 61 74 65  If the two state
8ed0: 6d 65 6e 74 73 20 63 6f 6e 74 61 69 6e 20 61 20  ments contain a 
8ee0: 64 69 66 66 65 72 65 6e 74 20 6e 75 6d 62 65 72  different number
8ef0: 20 6f 66 20 62 69 6e 64 69 6e 67 73 2c 20 74 68   of bindings, th
8f00: 65 6e 0a 2a 2a 20 61 6e 20 53 51 4c 49 54 45 5f  en.** an SQLITE_
8f10: 45 52 52 4f 52 20 69 73 20 72 65 74 75 72 6e 65  ERROR is returne
8f20: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
8f30: 33 54 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67  3TransferBinding
8f40: 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  s(sqlite3_stmt *
8f50: 70 46 72 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74  pFromStmt, sqlit
8f60: 65 33 5f 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74  e3_stmt *pToStmt
8f70: 29 7b 0a 20 20 56 64 62 65 20 2a 70 46 72 6f 6d  ){.  Vdbe *pFrom
8f80: 20 3d 20 28 56 64 62 65 2a 29 70 46 72 6f 6d 53   = (Vdbe*)pFromS
8f90: 74 6d 74 3b 0a 20 20 56 64 62 65 20 2a 70 54 6f  tmt;.  Vdbe *pTo
8fa0: 20 3d 20 28 56 64 62 65 2a 29 70 54 6f 53 74 6d   = (Vdbe*)pToStm
8fb0: 74 3b 0a 20 20 69 6e 74 20 69 2c 20 72 63 20 3d  t;.  int i, rc =
8fc0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66   SQLITE_OK;.  if
8fd0: 28 20 28 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21  ( (pFrom->magic!
8fe0: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20  =VDBE_MAGIC_RUN 
8ff0: 26 26 20 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21  && pFrom->magic!
9000: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54  =VDBE_MAGIC_HALT
9010: 29 0a 20 20 20 20 7c 7c 20 28 70 54 6f 2d 3e 6d  ).    || (pTo->m
9020: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
9030: 5f 52 55 4e 20 26 26 20 70 54 6f 2d 3e 6d 61 67  _RUN && pTo->mag
9040: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48  ic!=VDBE_MAGIC_H
9050: 41 4c 54 29 0a 20 20 20 20 7c 7c 20 70 54 6f 2d  ALT).    || pTo-
9060: 3e 64 62 21 3d 70 46 72 6f 6d 2d 3e 64 62 20 29  >db!=pFrom->db )
9070: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
9080: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
9090: 20 20 69 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61    if( pFrom->nVa
90a0: 72 21 3d 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a  r!=pTo->nVar ){.
90b0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
90c0: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 73  E_ERROR;.  }.  s
90d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
90e0: 65 72 28 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74 65  er(pTo->db->mute
90f0: 78 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 72  x);.  for(i=0; r
9100: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
9110: 69 3c 70 46 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69  i<pFrom->nVar; i
9120: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
9130: 56 64 62 65 4d 65 6d 4d 6f 76 65 28 26 70 54 6f  VdbeMemMove(&pTo
9140: 2d 3e 61 56 61 72 5b 69 5d 2c 20 26 70 46 72 6f  ->aVar[i], &pFro
9150: 6d 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 20 7d  m->aVar[i]);.  }
9160: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
9170: 5f 6c 65 61 76 65 28 70 54 6f 2d 3e 64 62 2d 3e  _leave(pTo->db->
9180: 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74  mutex);.  assert
9190: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
91a0: 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f  || rc==SQLITE_NO
91b0: 4d 45 4d 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  MEM );.  return 
91c0: 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53  rc;.}..#ifndef S
91d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45  QLITE_OMIT_DEPRE
91e0: 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72  CATED./*.** Depr
91f0: 65 63 61 74 65 64 20 65 78 74 65 72 6e 61 6c 20  ecated external 
9200: 69 6e 74 65 72 66 61 63 65 2e 20 20 49 6e 74 65  interface.  Inte
9210: 72 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65  rnal/core SQLite
9220: 20 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20   code.** should 
9230: 63 61 6c 6c 20 73 71 6c 69 74 65 33 54 72 61 6e  call sqlite3Tran
9240: 73 66 65 72 42 69 6e 64 69 6e 67 73 2e 0a 2a 2f  sferBindings..*/
9250: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 72 61  .int sqlite3_tra
9260: 6e 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28 73  nsfer_bindings(s
9270: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 46 72  qlite3_stmt *pFr
9280: 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65 33 5f  omStmt, sqlite3_
9290: 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29 7b 0a  stmt *pToStmt){.
92a0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
92b0: 54 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73  TransferBindings
92c0: 28 70 46 72 6f 6d 53 74 6d 74 2c 20 70 54 6f 53  (pFromStmt, pToS
92d0: 74 6d 74 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  tmt);.}.#endif..
92e0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
92f0: 20 73 71 6c 69 74 65 33 2a 20 64 61 74 61 62 61   sqlite3* databa
9300: 73 65 20 68 61 6e 64 6c 65 20 74 6f 20 77 68 69  se handle to whi
9310: 63 68 20 74 68 65 20 70 72 65 70 61 72 65 64 20  ch the prepared 
9320: 73 74 61 74 65 6d 65 6e 74 20 67 69 76 65 6e 0a  statement given.
9330: 2a 2a 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65  ** in the argume
9340: 6e 74 20 62 65 6c 6f 6e 67 73 2e 20 20 54 68 69  nt belongs.  Thi
9350: 73 20 69 73 20 74 68 65 20 73 61 6d 65 20 64 61  s is the same da
9360: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 68  tabase handle th
9370: 61 74 20 77 61 73 0a 2a 2a 20 74 68 65 20 66 69  at was.** the fi
9380: 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  rst argument to 
9390: 74 68 65 20 73 71 6c 69 74 65 33 5f 70 72 65 70  the sqlite3_prep
93a0: 61 72 65 28 29 20 74 68 61 74 20 77 61 73 20 75  are() that was u
93b0: 73 65 64 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a  sed to create.**
93c0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69   the statement i
93d0: 6e 20 74 68 65 20 66 69 72 73 74 20 70 6c 61 63  n the first plac
93e0: 65 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 20 2a 73  e..*/.sqlite3 *s
93f0: 71 6c 69 74 65 33 5f 64 62 5f 68 61 6e 64 6c 65  qlite3_db_handle
9400: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
9410: 53 74 6d 74 29 7b 0a 20 20 72 65 74 75 72 6e 20  Stmt){.  return 
9420: 70 53 74 6d 74 20 3f 20 28 28 56 64 62 65 2a 29  pStmt ? ((Vdbe*)
9430: 70 53 74 6d 74 29 2d 3e 64 62 20 3a 20 30 3b 0a  pStmt)->db : 0;.
9440: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
9450: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  a pointer to the
9460: 20 6e 65 78 74 20 70 72 65 70 61 72 65 64 20 73   next prepared s
9470: 74 61 74 65 6d 65 6e 74 20 61 66 74 65 72 20 70  tatement after p
9480: 53 74 6d 74 20 61 73 73 6f 63 69 61 74 65 64 0a  Stmt associated.
9490: 2a 2a 20 77 69 74 68 20 64 61 74 61 62 61 73 65  ** with database
94a0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 44 62 2e   connection pDb.
94b0: 20 20 49 66 20 70 53 74 6d 74 20 69 73 20 4e 55    If pStmt is NU
94c0: 4c 4c 2c 20 72 65 74 75 72 6e 20 74 68 65 20 66  LL, return the f
94d0: 69 72 73 74 0a 2a 2a 20 70 72 65 70 61 72 65 64  irst.** prepared
94e0: 20 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 20 74   statement for t
94f0: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  he database conn
9500: 65 63 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20  ection.  Return 
9510: 4e 55 4c 4c 20 69 66 20 74 68 65 72 65 0a 2a 2a  NULL if there.**
9520: 20 61 72 65 20 6e 6f 20 6d 6f 72 65 2e 0a 2a 2f   are no more..*/
9530: 0a 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 73  .sqlite3_stmt *s
9540: 71 6c 69 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74  qlite3_next_stmt
9550: 28 73 71 6c 69 74 65 33 20 2a 70 44 62 2c 20 73  (sqlite3 *pDb, s
9560: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
9570: 6d 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 73  mt){.  sqlite3_s
9580: 74 6d 74 20 2a 70 4e 65 78 74 3b 0a 20 20 73 71  tmt *pNext;.  sq
9590: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
95a0: 72 28 70 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  r(pDb->mutex);. 
95b0: 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b   if( pStmt==0 ){
95c0: 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 28 73 71  .    pNext = (sq
95d0: 6c 69 74 65 33 5f 73 74 6d 74 2a 29 70 44 62 2d  lite3_stmt*)pDb-
95e0: 3e 70 56 64 62 65 3b 0a 20 20 7d 65 6c 73 65 7b  >pVdbe;.  }else{
95f0: 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 28 73 71  .    pNext = (sq
9600: 6c 69 74 65 33 5f 73 74 6d 74 2a 29 28 28 56 64  lite3_stmt*)((Vd
9610: 62 65 2a 29 70 53 74 6d 74 29 2d 3e 70 4e 65 78  be*)pStmt)->pNex
9620: 74 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  t;.  }.  sqlite3
9630: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 44 62  _mutex_leave(pDb
9640: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75  ->mutex);.  retu
9650: 72 6e 20 70 4e 65 78 74 3b 0a 7d 0a 0a 2f 2a 0a  rn pNext;.}../*.
9660: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61  ** Return the va
9670: 6c 75 65 20 6f 66 20 61 20 73 74 61 74 75 73 20  lue of a status 
9680: 63 6f 75 6e 74 65 72 20 66 6f 72 20 61 20 70 72  counter for a pr
9690: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
96a0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
96b0: 73 74 6d 74 5f 73 74 61 74 75 73 28 73 71 6c 69  stmt_status(sqli
96c0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
96d0: 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20 72 65 73   int op, int res
96e0: 65 74 46 6c 61 67 29 7b 0a 20 20 56 64 62 65 20  etFlag){.  Vdbe 
96f0: 2a 70 56 64 62 65 20 3d 20 28 56 64 62 65 2a 29  *pVdbe = (Vdbe*)
9700: 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 76 20 3d  pStmt;.  int v =
9710: 20 70 56 64 62 65 2d 3e 61 43 6f 75 6e 74 65 72   pVdbe->aCounter
9720: 5b 6f 70 2d 31 5d 3b 0a 20 20 69 66 28 20 72 65  [op-1];.  if( re
9730: 73 65 74 46 6c 61 67 20 29 20 70 56 64 62 65 2d  setFlag ) pVdbe-
9740: 3e 61 43 6f 75 6e 74 65 72 5b 6f 70 2d 31 5d 20  >aCounter[op-1] 
9750: 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 76 3b  = 0;.  return v;
9760: 0a 7d 0a                                         .}.