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

Artifact b72aba838b4c804c5e281fe73a6e149aad222149:


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 33 31 20  beapi.c,v 1.131 
01e0: 32 30 30 38 2f 30 35 2f 31 36 20 30 34 3a 35 31  2008/05/16 04:51
01f0: 3a 35 35 20 64 61 6e 69 65 6c 6b 31 39 37 37 20  :55 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 64 65 66 20 53 51 4c  t.h"..#ifdef SQL
0240: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
0250: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a  Y_MANAGEMENT./*.
0260: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
0270: 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61   structure conta
0280: 69 6e 73 20 70 6f 69 6e 74 65 72 73 20 74 6f 20  ins pointers to 
0290: 74 68 65 20 65 6e 64 20 70 6f 69 6e 74 73 20 6f  the end points o
02a0: 66 20 61 0a 2a 2a 20 64 6f 75 62 6c 79 2d 6c 69  f a.** doubly-li
02b0: 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 61 6c 6c  nked list of all
02c0: 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20 73 74   compiled SQL st
02d0: 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 6d 61  atements that ma
02e0: 79 20 62 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20  y be holding.** 
02f0: 62 75 66 66 65 72 73 20 65 6c 69 67 69 62 6c 65  buffers eligible
0300: 20 66 6f 72 20 72 65 6c 65 61 73 65 20 77 68 65   for release whe
0310: 6e 20 74 68 65 20 73 71 6c 69 74 65 33 5f 72 65  n the sqlite3_re
0320: 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 20 69  lease_memory() i
0330: 6e 74 65 72 66 61 63 65 20 69 73 0a 2a 2a 20 69  nterface is.** i
0340: 6e 76 6f 6b 65 64 2e 20 41 63 63 65 73 73 20 74  nvoked. Access t
0350: 6f 20 74 68 69 73 20 6c 69 73 74 20 69 73 20 70  o this list is p
0360: 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65 20  rotected by the 
0370: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
0380: 54 49 43 5f 4c 52 55 32 0a 2a 2a 20 6d 75 74 65  TIC_LRU2.** mute
0390: 78 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 65 6d 65  x..**.** Stateme
03a0: 6e 74 73 20 61 72 65 20 61 64 64 65 64 20 74 6f  nts are added to
03b0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 69 73   the end of this
03c0: 20 6c 69 73 74 20 77 68 65 6e 20 73 71 6c 69 74   list when sqlit
03d0: 65 33 5f 72 65 73 65 74 28 29 20 69 73 0a 2a 2a  e3_reset() is.**
03e0: 20 63 61 6c 6c 65 64 2e 20 54 68 65 79 20 61 72   called. They ar
03f0: 65 20 72 65 6d 6f 76 65 64 20 65 69 74 68 65 72  e removed either
0400: 20 77 68 65 6e 20 73 71 6c 69 74 65 33 5f 73 74   when sqlite3_st
0410: 65 70 28 29 20 6f 72 20 73 71 6c 69 74 65 33 5f  ep() or sqlite3_
0420: 66 69 6e 61 6c 69 7a 65 28 29 0a 2a 2a 20 69 73  finalize().** is
0430: 20 63 61 6c 6c 65 64 2e 20 57 68 65 6e 20 73 74   called. When st
0440: 61 74 65 6d 65 6e 74 73 20 61 72 65 20 61 64 64  atements are add
0450: 65 64 20 74 6f 20 74 68 69 73 20 6c 69 73 74 2c  ed to this list,
0460: 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20   the associated 
0470: 0a 2a 2a 20 72 65 67 69 73 74 65 72 20 61 72 72  .** register arr
0480: 61 79 20 28 70 2d 3e 61 4d 65 6d 5b 31 2e 2e 70  ay (p->aMem[1..p
0490: 2d 3e 6e 4d 65 6d 5d 29 20 6d 61 79 20 63 6f 6e  ->nMem]) may con
04a0: 74 61 69 6e 20 64 79 6e 61 6d 69 63 20 62 75 66  tain dynamic buf
04b0: 66 65 72 73 20 74 68 61 74 0a 2a 2a 20 63 61 6e  fers that.** can
04c0: 20 62 65 20 66 72 65 65 64 20 75 73 69 6e 67 20   be freed using 
04d0: 73 71 6c 69 74 65 33 56 64 62 65 52 65 6c 65 61  sqlite3VdbeRelea
04e0: 73 65 4d 65 6d 6f 72 79 28 29 2e 0a 2a 2a 0a 2a  seMemory()..**.*
04f0: 2a 20 57 68 65 6e 20 73 74 61 74 65 6d 65 6e 74  * When statement
0500: 73 20 61 72 65 20 61 64 64 65 64 20 6f 72 20 72  s are added or r
0510: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 69 73  emoved from this
0520: 20 6c 69 73 74 2c 20 74 68 65 20 6d 75 74 65 78   list, the mutex
0530: 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77  .** associated w
0540: 69 74 68 20 74 68 65 20 56 64 62 65 20 62 65 69  ith the Vdbe bei
0550: 6e 67 20 61 64 64 65 64 20 6f 72 20 72 65 6d 6f  ng added or remo
0560: 76 65 64 20 28 56 64 62 65 2e 64 62 2d 3e 6d 75  ved (Vdbe.db->mu
0570: 74 65 78 29 20 69 73 0a 2a 2a 20 61 6c 72 65 61  tex) is.** alrea
0580: 64 79 20 68 65 6c 64 2e 20 54 68 65 20 4c 52 55  dy held. The LRU
0590: 32 20 6d 75 74 65 78 20 69 73 20 74 68 65 6e 20  2 mutex is then 
05a0: 6f 62 74 61 69 6e 65 64 2c 20 62 6c 6f 63 6b 69  obtained, blocki
05b0: 6e 67 20 69 66 20 6e 65 63 65 73 73 61 72 79 2c  ng if necessary,
05c0: 0a 2a 2a 20 74 68 65 20 6c 69 6e 6b 65 64 2d 6c  .** the linked-l
05d0: 69 73 74 20 70 6f 69 6e 74 65 72 73 20 6d 61 6e  ist pointers man
05e0: 69 70 75 6c 61 74 65 64 20 61 6e 64 20 74 68 65  ipulated and the
05f0: 20 4c 52 55 32 20 6d 75 74 65 78 20 72 65 6c 69   LRU2 mutex reli
0600: 6e 71 75 69 73 68 65 64 2e 0a 2a 2f 0a 73 74 72  nquished..*/.str
0610: 75 63 74 20 53 74 61 74 65 6d 65 6e 74 4c 72 75  uct StatementLru
0620: 4c 69 73 74 20 7b 0a 20 20 56 64 62 65 20 2a 70  List {.  Vdbe *p
0630: 46 69 72 73 74 3b 0a 20 20 56 64 62 65 20 2a 70  First;.  Vdbe *p
0640: 4c 61 73 74 3b 0a 7d 3b 0a 73 74 61 74 69 63 20  Last;.};.static 
0650: 73 74 72 75 63 74 20 53 74 61 74 65 6d 65 6e 74  struct Statement
0660: 4c 72 75 4c 69 73 74 20 73 71 6c 69 74 65 33 4c  LruList sqlite3L
0670: 72 75 53 74 61 74 65 6d 65 6e 74 73 3b 0a 0a 2f  ruStatements;../
0680: 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68 61 74 20  *.** Check that 
0690: 74 68 65 20 6c 69 73 74 20 6c 6f 6f 6b 73 20 74  the list looks t
06a0: 6f 20 62 65 20 69 6e 74 65 72 6e 61 6c 6c 79 20  o be internally 
06b0: 63 6f 6e 73 69 73 74 65 6e 74 2e 20 54 68 69 73  consistent. This
06c0: 20 69 73 20 75 73 65 64 0a 2a 2a 20 61 73 20 70   is used.** as p
06d0: 61 72 74 20 6f 66 20 61 6e 20 61 73 73 65 72 74  art of an assert
06e0: 28 29 20 73 74 61 74 65 6d 65 6e 74 20 61 73 20  () statement as 
06f0: 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20  follows:.**.**  
0700: 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72 75   assert( stmtLru
0710: 43 68 65 63 6b 28 29 20 29 3b 0a 2a 2f 0a 23 69  Check() );.*/.#i
0720: 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 73 74 61  fndef NDEBUG.sta
0730: 74 69 63 20 69 6e 74 20 73 74 6d 74 4c 72 75 43  tic int stmtLruC
0740: 68 65 63 6b 28 29 7b 0a 20 20 56 64 62 65 20 2a  heck(){.  Vdbe *
0750: 70 3b 0a 20 20 66 6f 72 28 70 3d 73 71 6c 69 74  p;.  for(p=sqlit
0760: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
0770: 70 46 69 72 73 74 3b 20 70 3b 20 70 3d 70 2d 3e  pFirst; p; p=p->
0780: 70 4c 72 75 4e 65 78 74 29 7b 0a 20 20 20 20 61  pLruNext){.    a
0790: 73 73 65 72 74 28 70 2d 3e 70 4c 72 75 4e 65 78  ssert(p->pLruNex
07a0: 74 20 7c 7c 20 70 3d 3d 73 71 6c 69 74 65 33 4c  t || p==sqlite3L
07b0: 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61  ruStatements.pLa
07c0: 73 74 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  st);.    assert(
07d0: 21 70 2d 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20  !p->pLruNext || 
07e0: 70 2d 3e 70 4c 72 75 4e 65 78 74 2d 3e 70 4c 72  p->pLruNext->pLr
07f0: 75 50 72 65 76 3d 3d 70 29 3b 0a 20 20 20 20 61  uPrev==p);.    a
0800: 73 73 65 72 74 28 70 2d 3e 70 4c 72 75 50 72 65  ssert(p->pLruPre
0810: 76 20 7c 7c 20 70 3d 3d 73 71 6c 69 74 65 33 4c  v || p==sqlite3L
0820: 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 46 69  ruStatements.pFi
0830: 72 73 74 29 3b 0a 20 20 20 20 61 73 73 65 72 74  rst);.    assert
0840: 28 21 70 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c  (!p->pLruPrev ||
0850: 20 70 2d 3e 70 4c 72 75 50 72 65 76 2d 3e 70 4c   p->pLruPrev->pL
0860: 72 75 4e 65 78 74 3d 3d 70 29 3b 0a 20 20 7d 0a  ruNext==p);.  }.
0870: 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 23 65    return 1;.}.#e
0880: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20  ndif../*.** Add 
0890: 76 64 62 65 20 70 20 74 6f 20 74 68 65 20 65 6e  vdbe p to the en
08a0: 64 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65  d of the stateme
08b0: 6e 74 20 6c 72 75 20 6c 69 73 74 2e 20 49 74 20  nt lru list. It 
08c0: 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 0a  is assumed that.
08d0: 2a 2a 20 70 20 69 73 20 6e 6f 74 20 61 6c 72 65  ** p is not alre
08e0: 61 64 79 20 70 61 72 74 20 6f 66 20 74 68 65 20  ady part of the 
08f0: 6c 69 73 74 20 77 68 65 6e 20 74 68 69 73 20 69  list when this i
0900: 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 20 6c 72  s called. The lr
0910: 75 20 6c 69 73 74 0a 2a 2a 20 69 73 20 70 72 6f  u list.** is pro
0920: 74 65 63 74 65 64 20 62 79 20 74 68 65 20 53 51  tected by the SQ
0930: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
0940: 43 5f 4c 52 55 20 6d 75 74 65 78 2e 0a 2a 2f 0a  C_LRU mutex..*/.
0950: 73 74 61 74 69 63 20 76 6f 69 64 20 73 74 6d 74  static void stmt
0960: 4c 72 75 41 64 64 28 56 64 62 65 20 2a 70 29 7b  LruAdd(Vdbe *p){
0970: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
0980: 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 5f 6d  _enter(sqlite3_m
0990: 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54  utex_alloc(SQLIT
09a0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
09b0: 52 55 32 29 29 3b 0a 0a 20 20 69 66 28 20 70 2d  RU2));..  if( p-
09c0: 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 2d 3e  >pLruPrev || p->
09d0: 70 4c 72 75 4e 65 78 74 20 7c 7c 20 73 71 6c 69  pLruNext || sqli
09e0: 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73  te3LruStatements
09f0: 2e 70 46 69 72 73 74 3d 3d 70 20 29 7b 0a 20 20  .pFirst==p ){.  
0a00: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
0a10: 6c 65 61 76 65 28 73 71 6c 69 74 65 33 5f 6d 75  leave(sqlite3_mu
0a20: 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45  tex_alloc(SQLITE
0a30: 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52  _MUTEX_STATIC_LR
0a40: 55 32 29 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  U2));.    return
0a50: 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28  ;.  }..  assert(
0a60: 20 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29 20   stmtLruCheck() 
0a70: 29 3b 0a 0a 20 20 69 66 28 20 21 73 71 6c 69 74  );..  if( !sqlit
0a80: 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e  e3LruStatements.
0a90: 70 46 69 72 73 74 20 29 7b 0a 20 20 20 20 61 73  pFirst ){.    as
0aa0: 73 65 72 74 28 20 21 73 71 6c 69 74 65 33 4c 72  sert( !sqlite3Lr
0ab0: 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73  uStatements.pLas
0ac0: 74 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  t );.    sqlite3
0ad0: 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 46  LruStatements.pF
0ae0: 69 72 73 74 20 3d 20 70 3b 0a 20 20 20 20 73 71  irst = p;.    sq
0af0: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0b00: 74 73 2e 70 4c 61 73 74 20 3d 20 70 3b 0a 20 20  ts.pLast = p;.  
0b10: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72  }else{.    asser
0b20: 74 28 20 21 73 71 6c 69 74 65 33 4c 72 75 53 74  t( !sqlite3LruSt
0b30: 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 2d 3e  atements.pLast->
0b40: 70 4c 72 75 4e 65 78 74 20 29 3b 0a 20 20 20 20  pLruNext );.    
0b50: 70 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 73 71  p->pLruPrev = sq
0b60: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0b70: 74 73 2e 70 4c 61 73 74 3b 0a 20 20 20 20 73 71  ts.pLast;.    sq
0b80: 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e  lite3LruStatemen
0b90: 74 73 2e 70 4c 61 73 74 2d 3e 70 4c 72 75 4e 65  ts.pLast->pLruNe
0ba0: 78 74 20 3d 20 70 3b 0a 20 20 20 20 73 71 6c 69  xt = p;.    sqli
0bb0: 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73  te3LruStatements
0bc0: 2e 70 4c 61 73 74 20 3d 20 70 3b 0a 20 20 7d 0a  .pLast = p;.  }.
0bd0: 0a 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c  .  assert( stmtL
0be0: 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 0a 20 20  ruCheck() );..  
0bf0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
0c00: 61 76 65 28 73 71 6c 69 74 65 33 5f 6d 75 74 65  ave(sqlite3_mute
0c10: 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d  x_alloc(SQLITE_M
0c20: 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32  UTEX_STATIC_LRU2
0c30: 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 73 73  ));.}../*.** Ass
0c40: 75 6d 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45  uming the SQLITE
0c50: 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52  _MUTEX_STATIC_LR
0c60: 55 32 20 6d 75 74 65 78 74 20 69 73 20 61 6c 72  U2 mutext is alr
0c70: 65 61 64 79 20 68 65 6c 64 2c 20 72 65 6d 6f 76  eady held, remov
0c80: 65 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 70  e.** statement p
0c90: 20 66 72 6f 6d 20 74 68 65 20 6c 65 61 73 74 2d   from the least-
0ca0: 72 65 63 65 6e 74 6c 79 2d 75 73 65 64 20 73 74  recently-used st
0cb0: 61 74 65 6d 65 6e 74 20 6c 69 73 74 2e 20 49 66  atement list. If
0cc0: 20 74 68 65 20 0a 2a 2a 20 73 74 61 74 65 6d 65   the .** stateme
0cd0: 6e 74 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e  nt is not curren
0ce0: 74 6c 79 20 70 61 72 74 20 6f 66 20 74 68 65 20  tly part of the 
0cf0: 6c 69 73 74 2c 20 74 68 69 73 20 63 61 6c 6c 20  list, this call 
0d00: 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73  is a no-op..*/.s
0d10: 74 61 74 69 63 20 76 6f 69 64 20 73 74 6d 74 4c  tatic void stmtL
0d20: 72 75 52 65 6d 6f 76 65 4e 6f 6d 75 74 65 78 28  ruRemoveNomutex(
0d30: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20  Vdbe *p){.  if( 
0d40: 70 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70  p->pLruPrev || p
0d50: 2d 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 70 3d  ->pLruNext || p=
0d60: 3d 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65  =sqlite3LruState
0d70: 6d 65 6e 74 73 2e 70 46 69 72 73 74 20 29 7b 0a  ments.pFirst ){.
0d80: 20 20 20 20 61 73 73 65 72 74 28 20 73 74 6d 74      assert( stmt
0d90: 4c 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 20 20  LruCheck() );.  
0da0: 20 20 69 66 28 20 70 2d 3e 70 4c 72 75 4e 65 78    if( p->pLruNex
0db0: 74 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4c  t ){.      p->pL
0dc0: 72 75 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76  ruNext->pLruPrev
0dd0: 20 3d 20 70 2d 3e 70 4c 72 75 50 72 65 76 3b 0a   = p->pLruPrev;.
0de0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
0df0: 20 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65   sqlite3LruState
0e00: 6d 65 6e 74 73 2e 70 4c 61 73 74 20 3d 20 70 2d  ments.pLast = p-
0e10: 3e 70 4c 72 75 50 72 65 76 3b 0a 20 20 20 20 7d  >pLruPrev;.    }
0e20: 0a 20 20 20 20 69 66 28 20 70 2d 3e 70 4c 72 75  .    if( p->pLru
0e30: 50 72 65 76 20 29 7b 0a 20 20 20 20 20 20 70 2d  Prev ){.      p-
0e40: 3e 70 4c 72 75 50 72 65 76 2d 3e 70 4c 72 75 4e  >pLruPrev->pLruN
0e50: 65 78 74 20 3d 20 70 2d 3e 70 4c 72 75 4e 65 78  ext = p->pLruNex
0e60: 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  t;.    }else{.  
0e70: 20 20 20 20 73 71 6c 69 74 65 33 4c 72 75 53 74      sqlite3LruSt
0e80: 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73 74 20  atements.pFirst 
0e90: 3d 20 70 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20  = p->pLruNext;. 
0ea0: 20 20 20 7d 0a 20 20 20 20 70 2d 3e 70 4c 72 75     }.    p->pLru
0eb0: 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 70 2d  Next = 0;.    p-
0ec0: 3e 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20  >pLruPrev = 0;. 
0ed0: 20 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c     assert( stmtL
0ee0: 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 20 20 7d  ruCheck() );.  }
0ef0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d 69  .}../*.** Assumi
0f00: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 55  ng the SQLITE_MU
0f10: 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 20  TEX_STATIC_LRU2 
0f20: 6d 75 74 65 78 74 20 69 73 20 6e 6f 74 20 68 65  mutext is not he
0f30: 6c 64 2c 20 72 65 6d 6f 76 65 0a 2a 2a 20 73 74  ld, remove.** st
0f40: 61 74 65 6d 65 6e 74 20 70 20 66 72 6f 6d 20 74  atement p from t
0f50: 68 65 20 6c 65 61 73 74 2d 72 65 63 65 6e 74 6c  he least-recentl
0f60: 79 2d 75 73 65 64 20 73 74 61 74 65 6d 65 6e 74  y-used statement
0f70: 20 6c 69 73 74 2e 20 49 66 20 74 68 65 20 0a 2a   list. If the .*
0f80: 2a 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6e  * statement is n
0f90: 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 70 61 72  ot currently par
0fa0: 74 20 6f 66 20 74 68 65 20 6c 69 73 74 2c 20 74  t of the list, t
0fb0: 68 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f  his call is a no
0fc0: 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  -op..*/.static v
0fd0: 6f 69 64 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76  oid stmtLruRemov
0fe0: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71  e(Vdbe *p){.  sq
0ff0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
1000: 72 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  r(sqlite3_mutex_
1010: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54  alloc(SQLITE_MUT
1020: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 29 29  EX_STATIC_LRU2))
1030: 3b 0a 20 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76  ;.  stmtLruRemov
1040: 65 4e 6f 6d 75 74 65 78 28 70 29 3b 0a 20 20 73  eNomutex(p);.  s
1050: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
1060: 76 65 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  ve(sqlite3_mutex
1070: 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55  _alloc(SQLITE_MU
1080: 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 29  TEX_STATIC_LRU2)
1090: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20  );.}../*.** Try 
10a0: 74 6f 20 72 65 6c 65 61 73 65 20 6e 20 62 79 74  to release n byt
10b0: 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 62 79 20  es of memory by 
10c0: 66 72 65 65 69 6e 67 20 62 75 66 66 65 72 73 20  freeing buffers 
10d0: 61 73 73 6f 63 69 61 74 65 64 20 0a 2a 2a 20 77  associated .** w
10e0: 69 74 68 20 74 68 65 20 6d 65 6d 6f 72 79 20 72  ith the memory r
10f0: 65 67 69 73 74 65 72 73 20 6f 66 20 63 75 72 72  egisters of curr
1100: 65 6e 74 6c 79 20 75 6e 75 73 65 64 20 76 64 62  ently unused vdb
1110: 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  es..*/.int sqlit
1120: 65 33 56 64 62 65 52 65 6c 65 61 73 65 4d 65 6d  e3VdbeReleaseMem
1130: 6f 72 79 28 69 6e 74 20 6e 29 7b 0a 20 20 56 64  ory(int n){.  Vd
1140: 62 65 20 2a 70 3b 0a 20 20 56 64 62 65 20 2a 70  be *p;.  Vdbe *p
1150: 4e 65 78 74 3b 0a 20 20 69 6e 74 20 6e 46 72 65  Next;.  int nFre
1160: 65 20 3d 20 30 3b 0a 0a 20 20 73 71 6c 69 74 65  e = 0;..  sqlite
1170: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 71  3_mutex_enter(sq
1180: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f  lite3_mutex_allo
1190: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53  c(SQLITE_MUTEX_S
11a0: 54 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 20 20  TATIC_LRU2));.  
11b0: 66 6f 72 28 70 3d 73 71 6c 69 74 65 33 4c 72 75  for(p=sqlite3Lru
11c0: 53 74 61 74 65 6d 65 6e 74 73 2e 70 46 69 72 73  Statements.pFirs
11d0: 74 3b 20 70 20 26 26 20 6e 46 72 65 65 3c 6e 3b  t; p && nFree<n;
11e0: 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 70   p=pNext){.    p
11f0: 4e 65 78 74 20 3d 20 70 2d 3e 70 4c 72 75 4e 65  Next = p->pLruNe
1200: 78 74 3b 0a 0a 20 20 20 20 2f 2a 20 46 6f 72 20  xt;..    /* For 
1210: 65 61 63 68 20 73 74 61 74 65 6d 65 6e 74 20 68  each statement h
1220: 61 6e 64 6c 65 20 69 6e 20 74 68 65 20 6c 72 75  andle in the lru
1230: 20 6c 69 73 74 2c 20 61 74 74 65 6d 70 74 20 74   list, attempt t
1240: 6f 20 6f 62 74 61 69 6e 20 74 68 65 0a 20 20 20  o obtain the.   
1250: 20 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 64   ** associated d
1260: 61 74 61 62 61 73 65 20 6d 75 74 65 78 2e 20 49  atabase mutex. I
1270: 66 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 6f  f it cannot be o
1280: 62 74 61 69 6e 65 64 2c 20 63 6f 6e 74 69 6e 75  btained, continu
1290: 65 0a 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 20  e.    ** to the 
12a0: 6e 65 78 74 20 73 74 61 74 65 6d 65 6e 74 20 68  next statement h
12b0: 61 6e 64 6c 65 2e 20 49 74 20 69 73 20 6e 6f 74  andle. It is not
12c0: 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 62 6c 6f   possible to blo
12d0: 63 6b 20 6f 6e 0a 20 20 20 20 2a 2a 20 74 68 65  ck on.    ** the
12e0: 20 64 61 74 61 62 61 73 65 20 6d 75 74 65 78 20   database mutex 
12f0: 2d 20 74 68 61 74 20 63 6f 75 6c 64 20 63 61 75  - that could cau
1300: 73 65 20 64 65 61 64 6c 6f 63 6b 2e 0a 20 20 20  se deadlock..   
1310: 20 2a 2f 0a 20 20 20 20 69 66 28 20 53 51 4c 49   */.    if( SQLI
1320: 54 45 5f 4f 4b 3d 3d 73 71 6c 69 74 65 33 5f 6d  TE_OK==sqlite3_m
1330: 75 74 65 78 5f 74 72 79 28 70 2d 3e 64 62 2d 3e  utex_try(p->db->
1340: 6d 75 74 65 78 29 20 29 7b 0a 20 20 20 20 20 20  mutex) ){.      
1350: 6e 46 72 65 65 20 2b 3d 20 73 71 6c 69 74 65 33  nFree += sqlite3
1360: 56 64 62 65 52 65 6c 65 61 73 65 42 75 66 66 65  VdbeReleaseBuffe
1370: 72 73 28 70 29 3b 0a 20 20 20 20 20 20 73 74 6d  rs(p);.      stm
1380: 74 4c 72 75 52 65 6d 6f 76 65 4e 6f 6d 75 74 65  tLruRemoveNomute
1390: 78 28 70 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  x(p);.      sqli
13a0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
13b0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
13c0: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
13d0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73  e3_mutex_leave(s
13e0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c  qlite3_mutex_all
13f0: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  oc(SQLITE_MUTEX_
1400: 53 54 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 0a  STATIC_LRU2));..
1410: 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b 0a    return nFree;.
1420: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 73 71  }../*.** Call sq
1430: 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 28 29  lite3Reprepare()
1440: 20 6f 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e   on the statemen
1450: 74 2e 20 52 65 6d 6f 76 65 20 69 74 20 66 72 6f  t. Remove it fro
1460: 6d 20 74 68 65 0a 2a 2a 20 6c 72 75 20 6c 69 73  m the.** lru lis
1470: 74 20 62 65 66 6f 72 65 20 64 6f 69 6e 67 20 73  t before doing s
1480: 6f 2c 20 61 73 20 52 65 70 72 65 70 61 72 65 28  o, as Reprepare(
1490: 29 20 77 69 6c 6c 20 66 72 65 65 20 61 6c 6c 20  ) will free all 
14a0: 74 68 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 72 65  the.** memory re
14b0: 67 69 73 74 65 72 20 62 75 66 66 65 72 73 20 61  gister buffers a
14c0: 6e 79 77 61 79 2e 0a 2a 2f 0a 69 6e 74 20 76 64  nyway..*/.int vd
14d0: 62 65 52 65 70 72 65 70 61 72 65 28 56 64 62 65  beReprepare(Vdbe
14e0: 20 2a 70 29 7b 0a 20 20 73 74 6d 74 4c 72 75 52   *p){.  stmtLruR
14f0: 65 6d 6f 76 65 28 70 29 3b 0a 20 20 72 65 74 75  emove(p);.  retu
1500: 72 6e 20 73 71 6c 69 74 65 33 52 65 70 72 65 70  rn sqlite3Reprep
1510: 61 72 65 28 70 29 3b 0a 7d 0a 0a 23 65 6c 73 65  are(p);.}..#else
1520: 20 20 20 20 20 20 20 2f 2a 20 21 53 51 4c 49 54         /* !SQLIT
1530: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
1540: 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a 20 20  MANAGEMENT */.  
1550: 23 64 65 66 69 6e 65 20 73 74 6d 74 4c 72 75 52  #define stmtLruR
1560: 65 6d 6f 76 65 28 78 29 0a 20 20 23 64 65 66 69  emove(x).  #defi
1570: 6e 65 20 73 74 6d 74 4c 72 75 41 64 64 28 78 29  ne stmtLruAdd(x)
1580: 0a 20 20 23 64 65 66 69 6e 65 20 76 64 62 65 52  .  #define vdbeR
1590: 65 70 72 65 70 61 72 65 28 78 29 20 73 71 6c 69  eprepare(x) sqli
15a0: 74 65 33 52 65 70 72 65 70 61 72 65 28 78 29 0a  te3Reprepare(x).
15b0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 52  #endif.../*.** R
15c0: 65 74 75 72 6e 20 54 52 55 45 20 28 6e 6f 6e 2d  eturn TRUE (non-
15d0: 7a 65 72 6f 29 20 6f 66 20 74 68 65 20 73 74 61  zero) of the sta
15e0: 74 65 6d 65 6e 74 20 73 75 70 70 6c 69 65 64 20  tement supplied 
15f0: 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 6e  as an argument n
1600: 65 65 64 73 0a 2a 2a 20 74 6f 20 62 65 20 72 65  eeds.** to be re
1610: 63 6f 6d 70 69 6c 65 64 2e 20 20 41 20 73 74 61  compiled.  A sta
1620: 74 65 6d 65 6e 74 20 6e 65 65 64 73 20 74 6f 20  tement needs to 
1630: 62 65 20 72 65 63 6f 6d 70 69 6c 65 64 20 77 68  be recompiled wh
1640: 65 6e 65 76 65 72 20 74 68 65 0a 2a 2a 20 65 78  enever the.** ex
1650: 65 63 75 74 69 6f 6e 20 65 6e 76 69 72 6f 6e 6d  ecution environm
1660: 65 6e 74 20 63 68 61 6e 67 65 73 20 69 6e 20 61  ent changes in a
1670: 20 77 61 79 20 74 68 61 74 20 77 6f 75 6c 64 20   way that would 
1680: 61 6c 74 65 72 20 74 68 65 20 70 72 6f 67 72 61  alter the progra
1690: 6d 0a 2a 2a 20 74 68 61 74 20 73 71 6c 69 74 65  m.** that sqlite
16a0: 33 5f 70 72 65 70 61 72 65 28 29 20 67 65 6e 65  3_prepare() gene
16b0: 72 61 74 65 73 2e 20 20 46 6f 72 20 65 78 61 6d  rates.  For exam
16c0: 70 6c 65 2c 20 69 66 20 6e 65 77 20 66 75 6e 63  ple, if new func
16d0: 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 63 6f 6c 6c  tions or.** coll
16e0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20  ating sequences 
16f0: 61 72 65 20 72 65 67 69 73 74 65 72 65 64 20 6f  are registered o
1700: 72 20 69 66 20 61 6e 20 61 75 74 68 6f 72 69 7a  r if an authoriz
1710: 65 72 20 66 75 6e 63 74 69 6f 6e 20 69 73 0a 2a  er function is.*
1720: 2a 20 61 64 64 65 64 20 6f 72 20 63 68 61 6e 67  * added or chang
1730: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
1740: 65 33 5f 65 78 70 69 72 65 64 28 73 71 6c 69 74  e3_expired(sqlit
1750: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
1760: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
1770: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 72 65 74  be*)pStmt;.  ret
1780: 75 72 6e 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 65  urn p==0 || p->e
1790: 78 70 69 72 65 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  xpired;.}../*.**
17a0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72   The following r
17b0: 6f 75 74 69 6e 65 20 64 65 73 74 72 6f 79 73 20  outine destroys 
17c0: 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e  a virtual machin
17d0: 65 20 74 68 61 74 20 69 73 20 63 72 65 61 74 65  e that is create
17e0: 64 20 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69  d by.** the sqli
17f0: 74 65 33 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f  te3_compile() ro
1800: 75 74 69 6e 65 2e 20 54 68 65 20 69 6e 74 65 67  utine. The integ
1810: 65 72 20 72 65 74 75 72 6e 65 64 20 69 73 20 61  er returned is a
1820: 6e 20 53 51 4c 49 54 45 5f 0a 2a 2a 20 73 75 63  n SQLITE_.** suc
1830: 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f 64  cess/failure cod
1840: 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73  e that describes
1850: 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 65   the result of e
1860: 78 65 63 75 74 69 6e 67 20 74 68 65 20 76 69 72  xecuting the vir
1870: 74 75 61 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65 2e  tual.** machine.
1880: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
1890: 69 6e 65 20 73 65 74 73 20 74 68 65 20 65 72 72  ine sets the err
18a0: 6f 72 20 63 6f 64 65 20 61 6e 64 20 73 74 72 69  or code and stri
18b0: 6e 67 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a  ng returned by.*
18c0: 2a 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64  * sqlite3_errcod
18d0: 65 28 29 2c 20 73 71 6c 69 74 65 33 5f 65 72 72  e(), sqlite3_err
18e0: 6d 73 67 28 29 20 61 6e 64 20 73 71 6c 69 74 65  msg() and sqlite
18f0: 33 5f 65 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f  3_errmsg16()..*/
1900: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 66 69 6e  .int sqlite3_fin
1910: 61 6c 69 7a 65 28 73 71 6c 69 74 65 33 5f 73 74  alize(sqlite3_st
1920: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e  mt *pStmt){.  in
1930: 74 20 72 63 3b 0a 20 20 69 66 28 20 70 53 74 6d  t rc;.  if( pStm
1940: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d  t==0 ){.    rc =
1950: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65   SQLITE_OK;.  }e
1960: 6c 73 65 7b 0a 20 20 20 20 56 64 62 65 20 2a 76  lse{.    Vdbe *v
1970: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b   = (Vdbe*)pStmt;
1980: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
1990: 4d 55 54 45 58 5f 4e 4f 4f 50 0a 20 20 20 20 73  MUTEX_NOOP.    s
19a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75  qlite3_mutex *mu
19b0: 74 65 78 20 3d 20 76 2d 3e 64 62 2d 3e 6d 75 74  tex = v->db->mut
19c0: 65 78 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73  ex;.#endif.    s
19d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
19e0: 65 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 73  er(mutex);.    s
19f0: 74 6d 74 4c 72 75 52 65 6d 6f 76 65 28 76 29 3b  tmtLruRemove(v);
1a00: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
1a10: 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28 76 29  3VdbeFinalize(v)
1a20: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
1a30: 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 29  tex_leave(mutex)
1a40: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
1a50: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d  c;.}../*.** Term
1a60: 69 6e 61 74 65 20 74 68 65 20 63 75 72 72 65 6e  inate the curren
1a70: 74 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 61  t execution of a
1a80: 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  n SQL statement 
1a90: 61 6e 64 20 72 65 73 65 74 20 69 74 0a 2a 2a 20  and reset it.** 
1aa0: 62 61 63 6b 20 74 6f 20 69 74 73 20 73 74 61 72  back to its star
1ab0: 74 69 6e 67 20 73 74 61 74 65 20 73 6f 20 74 68  ting state so th
1ac0: 61 74 20 69 74 20 63 61 6e 20 62 65 20 72 65 75  at it can be reu
1ad0: 73 65 64 2e 20 41 20 73 75 63 63 65 73 73 20 63  sed. A success c
1ae0: 6f 64 65 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20  ode from.** the 
1af0: 70 72 69 6f 72 20 65 78 65 63 75 74 69 6f 6e 20  prior execution 
1b00: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a  is returned..**.
1b10: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
1b20: 73 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 63  sets the error c
1b30: 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20 72  ode and string r
1b40: 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71  eturned by.** sq
1b50: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 2c  lite3_errcode(),
1b60: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28   sqlite3_errmsg(
1b70: 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65 72  ) and sqlite3_er
1b80: 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74  rmsg16()..*/.int
1b90: 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 73   sqlite3_reset(s
1ba0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
1bb0: 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  mt){.  int rc;. 
1bc0: 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b   if( pStmt==0 ){
1bd0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
1be0: 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  _OK;.  }else{.  
1bf0: 20 20 56 64 62 65 20 2a 76 20 3d 20 28 56 64 62    Vdbe *v = (Vdb
1c00: 65 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20 73 71  e*)pStmt;.    sq
1c10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
1c20: 72 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b  r(v->db->mutex);
1c30: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
1c40: 33 56 64 62 65 52 65 73 65 74 28 76 2c 20 31 29  3VdbeReset(v, 1)
1c50: 3b 0a 20 20 20 20 73 74 6d 74 4c 72 75 41 64 64  ;.    stmtLruAdd
1c60: 28 76 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  (v);.    sqlite3
1c70: 56 64 62 65 4d 61 6b 65 52 65 61 64 79 28 76 2c  VdbeMakeReady(v,
1c80: 20 2d 31 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20   -1, 0, 0, 0);. 
1c90: 20 20 20 61 73 73 65 72 74 28 20 28 72 63 20 26     assert( (rc &
1ca0: 20 28 76 2d 3e 64 62 2d 3e 65 72 72 4d 61 73 6b   (v->db->errMask
1cb0: 29 29 3d 3d 72 63 20 29 3b 0a 20 20 20 20 73 71  ))==rc );.    sq
1cc0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
1cd0: 65 28 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b  e(v->db->mutex);
1ce0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
1cf0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61  ;.}../*.** Set a
1d00: 6c 6c 20 74 68 65 20 70 61 72 61 6d 65 74 65 72  ll the parameter
1d10: 73 20 69 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65  s in the compile
1d20: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  d SQL statement 
1d30: 74 6f 20 4e 55 4c 4c 2e 0a 2a 2f 0a 69 6e 74 20  to NULL..*/.int 
1d40: 73 71 6c 69 74 65 33 5f 63 6c 65 61 72 5f 62 69  sqlite3_clear_bi
1d50: 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73  ndings(sqlite3_s
1d60: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69  tmt *pStmt){.  i
1d70: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d  nt i;.  int rc =
1d80: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 56 64   SQLITE_OK;.  Vd
1d90: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70  be *p = (Vdbe*)p
1da0: 53 74 6d 74 3b 0a 23 69 66 6e 64 65 66 20 53 51  Stmt;.#ifndef SQ
1db0: 4c 49 54 45 5f 4d 55 54 45 58 5f 4e 4f 4f 50 0a  LITE_MUTEX_NOOP.
1dc0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
1dd0: 2a 6d 75 74 65 78 20 3d 20 28 28 56 64 62 65 2a  *mutex = ((Vdbe*
1de0: 29 70 53 74 6d 74 29 2d 3e 64 62 2d 3e 6d 75 74  )pStmt)->db->mut
1df0: 65 78 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c  ex;.#endif.  sql
1e00: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
1e10: 28 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 69  (mutex);.  for(i
1e20: 3d 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69  =0; i<p->nVar; i
1e30: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
1e40: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26  VdbeMemRelease(&
1e50: 70 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 20 20  p->aVar[i]);.   
1e60: 20 70 2d 3e 61 56 61 72 5b 69 5d 2e 66 6c 61 67   p->aVar[i].flag
1e70: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20  s = MEM_Null;.  
1e80: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  }.  sqlite3_mute
1e90: 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 29 3b 0a  x_leave(mutex);.
1ea0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
1eb0: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
1ec0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73  ************** s
1ed0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 20 20 2a  qlite3_value_  *
1ee0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1ef0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
1f00: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
1f10: 72 6f 75 74 69 6e 65 73 20 65 78 74 72 61 63 74  routines extract
1f20: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f   information fro
1f30: 6d 20 61 20 4d 65 6d 20 6f 72 20 73 71 6c 69 74  m a Mem or sqlit
1f40: 65 33 5f 76 61 6c 75 65 0a 2a 2a 20 73 74 72 75  e3_value.** stru
1f50: 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f 6e 73 74 20  cture..*/.const 
1f60: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61  void *sqlite3_va
1f70: 6c 75 65 5f 62 6c 6f 62 28 73 71 6c 69 74 65 33  lue_blob(sqlite3
1f80: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
1f90: 20 4d 65 6d 20 2a 70 20 3d 20 28 4d 65 6d 2a 29   Mem *p = (Mem*)
1fa0: 70 56 61 6c 3b 0a 20 20 69 66 28 20 70 2d 3e 66  pVal;.  if( p->f
1fb0: 6c 61 67 73 20 26 20 28 4d 45 4d 5f 42 6c 6f 62  lags & (MEM_Blob
1fc0: 7c 4d 45 4d 5f 53 74 72 29 20 29 7b 0a 20 20 20  |MEM_Str) ){.   
1fd0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45   sqlite3VdbeMemE
1fe0: 78 70 61 6e 64 42 6c 6f 62 28 70 29 3b 0a 20 20  xpandBlob(p);.  
1ff0: 20 20 70 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 4d    p->flags &= ~M
2000: 45 4d 5f 53 74 72 3b 0a 20 20 20 20 70 2d 3e 66  EM_Str;.    p->f
2010: 6c 61 67 73 20 7c 3d 20 4d 45 4d 5f 42 6c 6f 62  lags |= MEM_Blob
2020: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 2d 3e  ;.    return p->
2030: 7a 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  z;.  }else{.    
2040: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76  return sqlite3_v
2050: 61 6c 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b  alue_text(pVal);
2060: 0a 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74  .  }.}.int sqlit
2070: 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73  e3_value_bytes(s
2080: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
2090: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  al){.  return sq
20a0: 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28  lite3ValueBytes(
20b0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  pVal, SQLITE_UTF
20c0: 38 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  8);.}.int sqlite
20d0: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28  3_value_bytes16(
20e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70  sqlite3_value *p
20f0: 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  Val){.  return s
2100: 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73  qlite3ValueBytes
2110: 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54  (pVal, SQLITE_UT
2120: 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f  F16NATIVE);.}.do
2130: 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c  uble sqlite3_val
2140: 75 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65  ue_double(sqlite
2150: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a  3_value *pVal){.
2160: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
2170: 56 64 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d  VdbeRealValue((M
2180: 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74  em*)pVal);.}.int
2190: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69   sqlite3_value_i
21a0: 6e 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  nt(sqlite3_value
21b0: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72   *pVal){.  retur
21c0: 6e 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74  n sqlite3VdbeInt
21d0: 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c  Value((Mem*)pVal
21e0: 29 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36  );.}.sqlite_int6
21f0: 34 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  4 sqlite3_value_
2200: 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 76 61  int64(sqlite3_va
2210: 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65  lue *pVal){.  re
2220: 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65  turn sqlite3Vdbe
2230: 49 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70  IntValue((Mem*)p
2240: 56 61 6c 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e  Val);.}.const un
2250: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c  signed char *sql
2260: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28  ite3_value_text(
2270: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70  sqlite3_value *p
2280: 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 28  Val){.  return (
2290: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
22a0: 68 61 72 20 2a 29 73 71 6c 69 74 65 33 56 61 6c  har *)sqlite3Val
22b0: 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c  ueText(pVal, SQL
22c0: 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a 23 69 66  ITE_UTF8);.}.#if
22d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
22e0: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69  _UTF16.const voi
22f0: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  d *sqlite3_value
2300: 5f 74 65 78 74 31 36 28 73 71 6c 69 74 65 33 5f  _text16(sqlite3_
2310: 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 20  value* pVal){.  
2320: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61  return sqlite3Va
2330: 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51  lueText(pVal, SQ
2340: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45  LITE_UTF16NATIVE
2350: 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 20  );.}.const void 
2360: 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  *sqlite3_value_t
2370: 65 78 74 31 36 62 65 28 73 71 6c 69 74 65 33 5f  ext16be(sqlite3_
2380: 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20  value *pVal){.  
2390: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 61  return sqlite3Va
23a0: 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51  lueText(pVal, SQ
23b0: 4c 49 54 45 5f 55 54 46 31 36 42 45 29 3b 0a 7d  LITE_UTF16BE);.}
23c0: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
23d0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
23e0: 36 6c 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  6le(sqlite3_valu
23f0: 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75  e *pVal){.  retu
2400: 72 6e 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54  rn sqlite3ValueT
2410: 65 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45  ext(pVal, SQLITE
2420: 5f 55 54 46 31 36 4c 45 29 3b 0a 7d 0a 23 65 6e  _UTF16LE);.}.#en
2430: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
2440: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20  IT_UTF16 */.int 
2450: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
2460: 70 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  pe(sqlite3_value
2470: 2a 20 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72  * pVal){.  retur
2480: 6e 20 70 56 61 6c 2d 3e 74 79 70 65 3b 0a 7d 0a  n pVal->type;.}.
2490: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
24a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73  ************** s
24b0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 20 20  qlite3_result_  
24c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
24d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a  ***************.
24e0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
24f0: 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73   routines are us
2500: 65 64 20 62 79 20 75 73 65 72 2d 64 65 66 69 6e  ed by user-defin
2510: 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20  ed functions to 
2520: 73 70 65 63 69 66 79 0a 2a 2a 20 74 68 65 20 66  specify.** the f
2530: 75 6e 63 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0a  unction result..
2540: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  */.void sqlite3_
2550: 72 65 73 75 6c 74 5f 62 6c 6f 62 28 0a 20 20 73  result_blob(.  s
2560: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
2570: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76  pCtx, .  const v
2580: 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e  oid *z, .  int n
2590: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  , .  void (*xDel
25a0: 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61  )(void *).){.  a
25b0: 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a 20  ssert( n>=0 );. 
25c0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
25d0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78  _mutex_held(pCtx
25e0: 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29  ->s.db->mutex) )
25f0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
2600: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e  emSetStr(&pCtx->
2610: 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78 44 65 6c  s, z, n, 0, xDel
2620: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
2630: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
2640: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
2650: 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65 20 72 56  *pCtx, double rV
2660: 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73  al){.  assert( s
2670: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
2680: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75  d(pCtx->s.db->mu
2690: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  tex) );.  sqlite
26a0: 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c  3VdbeMemSetDoubl
26b0: 65 28 26 70 43 74 78 2d 3e 73 2c 20 72 56 61 6c  e(&pCtx->s, rVal
26c0: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
26d0: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 73  3_result_error(s
26e0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
26f0: 70 43 74 78 2c 20 63 6f 6e 73 74 20 63 68 61 72  pCtx, const char
2700: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 61   *z, int n){.  a
2710: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
2720: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
2730: 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  s.db->mutex) );.
2740: 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20    pCtx->isError 
2750: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
2760: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
2770: 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c  SetStr(&pCtx->s,
2780: 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54   z, n, SQLITE_UT
2790: 46 38 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e 53  F8, SQLITE_TRANS
27a0: 49 45 4e 54 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  IENT);.}.#ifndef
27b0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
27c0: 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f  16.void sqlite3_
27d0: 72 65 73 75 6c 74 5f 65 72 72 6f 72 31 36 28 73  result_error16(s
27e0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
27f0: 70 43 74 78 2c 20 63 6f 6e 73 74 20 76 6f 69 64  pCtx, const void
2800: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 61   *z, int n){.  a
2810: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
2820: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
2830: 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  s.db->mutex) );.
2840: 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20    pCtx->isError 
2850: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
2860: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
2870: 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c  SetStr(&pCtx->s,
2880: 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54   z, n, SQLITE_UT
2890: 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 54  F16NATIVE, SQLIT
28a0: 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a  E_TRANSIENT);.}.
28b0: 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69  #endif.void sqli
28c0: 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 73  te3_result_int(s
28d0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
28e0: 70 43 74 78 2c 20 69 6e 74 20 69 56 61 6c 29 7b  pCtx, int iVal){
28f0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
2900: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
2910: 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29  tx->s.db->mutex)
2920: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   );.  sqlite3Vdb
2930: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 43  eMemSetInt64(&pC
2940: 74 78 2d 3e 73 2c 20 28 69 36 34 29 69 56 61 6c  tx->s, (i64)iVal
2950: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
2960: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 73  3_result_int64(s
2970: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
2980: 70 43 74 78 2c 20 69 36 34 20 69 56 61 6c 29 7b  pCtx, i64 iVal){
2990: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
29a0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
29b0: 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29  tx->s.db->mutex)
29c0: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   );.  sqlite3Vdb
29d0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 43  eMemSetInt64(&pC
29e0: 74 78 2d 3e 73 2c 20 69 56 61 6c 29 3b 0a 7d 0a  tx->s, iVal);.}.
29f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73  void sqlite3_res
2a00: 75 6c 74 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33  ult_null(sqlite3
2a10: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 29 7b  _context *pCtx){
2a20: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
2a30: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
2a40: 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29  tx->s.db->mutex)
2a50: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62   );.  sqlite3Vdb
2a60: 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 26 70 43 74  eMemSetNull(&pCt
2a70: 78 2d 3e 73 29 3b 0a 7d 0a 76 6f 69 64 20 73 71  x->s);.}.void sq
2a80: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78  lite3_result_tex
2a90: 74 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  t(.  sqlite3_con
2aa0: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63  text *pCtx, .  c
2ab0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 0a 20  onst char *z, . 
2ac0: 20 69 6e 74 20 6e 2c 0a 20 20 76 6f 69 64 20 28   int n,.  void (
2ad0: 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29  *xDel)(void *).)
2ae0: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  {.  assert( sqli
2af0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
2b00: 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78  Ctx->s.db->mutex
2b10: 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  ) );.  sqlite3Vd
2b20: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74  beMemSetStr(&pCt
2b30: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49  x->s, z, n, SQLI
2b40: 54 45 5f 55 54 46 38 2c 20 78 44 65 6c 29 3b 0a  TE_UTF8, xDel);.
2b50: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
2b60: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 76 6f 69 64  _OMIT_UTF16.void
2b70: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
2b80: 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 74 65  text16(.  sqlite
2b90: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
2ba0: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
2bb0: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
2bc0: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
2bd0: 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74  d *).){.  assert
2be0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
2bf0: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d  held(pCtx->s.db-
2c00: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c  >mutex) );.  sql
2c10: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
2c20: 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e  r(&pCtx->s, z, n
2c30: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41  , SQLITE_UTF16NA
2c40: 54 49 56 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76  TIVE, xDel);.}.v
2c50: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
2c60: 6c 74 5f 74 65 78 74 31 36 62 65 28 0a 20 20 73  lt_text16be(.  s
2c70: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
2c80: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76  pCtx, .  const v
2c90: 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e  oid *z, .  int n
2ca0: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  , .  void (*xDel
2cb0: 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61  )(void *).){.  a
2cc0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
2cd0: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
2ce0: 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  s.db->mutex) );.
2cf0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
2d00: 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c  SetStr(&pCtx->s,
2d10: 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54   z, n, SQLITE_UT
2d20: 46 31 36 42 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a  F16BE, xDel);.}.
2d30: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73  void sqlite3_res
2d40: 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 0a 20 20  ult_text16le(.  
2d50: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
2d60: 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20  *pCtx, .  const 
2d70: 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20  void *z, .  int 
2d80: 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65  n, .  void (*xDe
2d90: 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20  l)(void *).){.  
2da0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
2db0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d  mutex_held(pCtx-
2dc0: 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  >s.db->mutex) );
2dd0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  .  sqlite3VdbeMe
2de0: 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73  mSetStr(&pCtx->s
2df0: 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55  , z, n, SQLITE_U
2e00: 54 46 31 36 4c 45 2c 20 78 44 65 6c 29 3b 0a 7d  TF16LE, xDel);.}
2e10: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
2e20: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a  E_OMIT_UTF16 */.
2e30: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73  void sqlite3_res
2e40: 75 6c 74 5f 76 61 6c 75 65 28 73 71 6c 69 74 65  ult_value(sqlite
2e50: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
2e60: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
2e70: 70 56 61 6c 75 65 29 7b 0a 20 20 61 73 73 65 72  pValue){.  asser
2e80: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
2e90: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62  _held(pCtx->s.db
2ea0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71  ->mutex) );.  sq
2eb0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79  lite3VdbeMemCopy
2ec0: 28 26 70 43 74 78 2d 3e 73 2c 20 70 56 61 6c 75  (&pCtx->s, pValu
2ed0: 65 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74  e);.}.void sqlit
2ee0: 65 33 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c  e3_result_zerobl
2ef0: 6f 62 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  ob(sqlite3_conte
2f00: 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 6e 29  xt *pCtx, int n)
2f10: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  {.  assert( sqli
2f20: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
2f30: 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78  Ctx->s.db->mutex
2f40: 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  ) );.  sqlite3Vd
2f50: 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62  beMemSetZeroBlob
2f60: 28 26 70 43 74 78 2d 3e 73 2c 20 6e 29 3b 0a 7d  (&pCtx->s, n);.}
2f70: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65  .void sqlite3_re
2f80: 73 75 6c 74 5f 65 72 72 6f 72 5f 63 6f 64 65 28  sult_error_code(
2f90: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
2fa0: 2a 70 43 74 78 2c 20 69 6e 74 20 65 72 72 43 6f  *pCtx, int errCo
2fb0: 64 65 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73 45  de){.  pCtx->isE
2fc0: 72 72 6f 72 20 3d 20 65 72 72 43 6f 64 65 3b 0a  rror = errCode;.
2fd0: 7d 0a 0a 2f 2a 20 46 6f 72 63 65 20 61 6e 20 53  }../* Force an S
2fe0: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 20 65 72 72  QLITE_TOOBIG err
2ff0: 6f 72 2e 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  or. */.void sqli
3000: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
3010: 5f 74 6f 6f 62 69 67 28 73 71 6c 69 74 65 33 5f  _toobig(sqlite3_
3020: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a  context *pCtx){.
3030: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3040: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
3050: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
3060: 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73 45 72 72  );.  pCtx->isErr
3070: 6f 72 20 3d 20 53 51 4c 49 54 45 5f 54 4f 4f 42  or = SQLITE_TOOB
3080: 49 47 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  IG;.  sqlite3Vdb
3090: 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 78  eMemSetStr(&pCtx
30a0: 2d 3e 73 2c 20 22 73 74 72 69 6e 67 20 6f 72 20  ->s, "string or 
30b0: 62 6c 6f 62 20 74 6f 6f 20 62 69 67 22 2c 20 2d  blob too big", -
30c0: 31 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20  1, .            
30d0: 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54             SQLIT
30e0: 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53  E_UTF8, SQLITE_S
30f0: 54 41 54 49 43 29 3b 0a 7d 0a 0a 2f 2a 20 41 6e  TATIC);.}../* An
3100: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 65 72   SQLITE_NOMEM er
3110: 72 6f 72 2e 20 2a 2f 0a 76 6f 69 64 20 73 71 6c  ror. */.void sql
3120: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f  ite3_result_erro
3130: 72 5f 6e 6f 6d 65 6d 28 73 71 6c 69 74 65 33 5f  r_nomem(sqlite3_
3140: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a  context *pCtx){.
3150: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3160: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74  3_mutex_held(pCt
3170: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20  x->s.db->mutex) 
3180: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
3190: 4d 65 6d 53 65 74 4e 75 6c 6c 28 26 70 43 74 78  MemSetNull(&pCtx
31a0: 2d 3e 73 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73  ->s);.  pCtx->is
31b0: 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45 5f 4e  Error = SQLITE_N
31c0: 4f 4d 45 4d 3b 0a 20 20 70 43 74 78 2d 3e 73 2e  OMEM;.  pCtx->s.
31d0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
31e0: 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45   = 1;.}../*.** E
31f0: 78 65 63 75 74 65 20 74 68 65 20 73 74 61 74 65  xecute the state
3200: 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65 69 74 68  ment pStmt, eith
3210: 65 72 20 75 6e 74 69 6c 20 61 20 72 6f 77 20 6f  er until a row o
3220: 66 20 64 61 74 61 20 69 73 20 72 65 61 64 79 2c  f data is ready,
3230: 20 74 68 65 0a 2a 2a 20 73 74 61 74 65 6d 65 6e   the.** statemen
3240: 74 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20  t is completely 
3250: 65 78 65 63 75 74 65 64 20 6f 72 20 61 6e 20 65  executed or an e
3260: 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a  rror occurs..**.
3270: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
3280: 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 62  implements the b
3290: 75 6c 6b 20 6f 66 20 74 68 65 20 6c 6f 67 69 63  ulk of the logic
32a0: 20 62 65 68 69 6e 64 20 74 68 65 20 73 71 6c 69   behind the sqli
32b0: 74 65 5f 73 74 65 70 28 29 0a 2a 2a 20 41 50 49  te_step().** API
32c0: 2e 20 20 54 68 65 20 6f 6e 6c 79 20 74 68 69 6e  .  The only thin
32d0: 67 20 6f 6d 69 74 74 65 64 20 69 73 20 74 68 65  g omitted is the
32e0: 20 61 75 74 6f 6d 61 74 69 63 20 72 65 63 6f 6d   automatic recom
32f0: 70 69 6c 65 20 69 66 20 61 20 0a 2a 2a 20 73 63  pile if a .** sc
3300: 68 65 6d 61 20 63 68 61 6e 67 65 20 68 61 73 20  hema change has 
3310: 6f 63 63 75 72 72 65 64 2e 20 20 54 68 61 74 20  occurred.  That 
3320: 64 65 74 61 69 6c 20 69 73 20 68 61 6e 64 6c 65  detail is handle
3330: 64 20 62 79 20 74 68 65 0a 2a 2a 20 6f 75 74 65  d by the.** oute
3340: 72 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  r sqlite3_step()
3350: 20 77 72 61 70 70 65 72 20 70 72 6f 63 65 64 75   wrapper procedu
3360: 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  re..*/.static in
3370: 74 20 73 71 6c 69 74 65 33 53 74 65 70 28 56 64  t sqlite3Step(Vd
3380: 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65  be *p){.  sqlite
3390: 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b  3 *db;.  int rc;
33a0: 0a 0a 20 20 61 73 73 65 72 74 28 70 29 3b 0a 20  ..  assert(p);. 
33b0: 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56   if( p->magic!=V
33c0: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b  DBE_MAGIC_RUN ){
33d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
33e0: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a  TE_MISUSE;.  }..
33f0: 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74    /* Assert that
3400: 20 6d 61 6c 6c 6f 63 28 29 20 68 61 73 20 6e 6f   malloc() has no
3410: 74 20 66 61 69 6c 65 64 20 2a 2f 0a 20 20 64 62  t failed */.  db
3420: 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 61 73 73 65   = p->db;.  asse
3430: 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46  rt( !db->mallocF
3440: 61 69 6c 65 64 20 29 3b 0a 0a 20 20 69 66 28 20  ailed );..  if( 
3450: 70 2d 3e 61 62 6f 72 74 65 64 20 29 7b 0a 20 20  p->aborted ){.  
3460: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
3470: 41 42 4f 52 54 3b 0a 20 20 7d 0a 20 20 69 66 28  ABORT;.  }.  if(
3480: 20 70 2d 3e 70 63 3c 3d 30 20 26 26 20 70 2d 3e   p->pc<=0 && p->
3490: 65 78 70 69 72 65 64 20 29 7b 0a 20 20 20 20 69  expired ){.    i
34a0: 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  f( p->rc==SQLITE
34b0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e  _OK ){.      p->
34c0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45  rc = SQLITE_SCHE
34d0: 4d 41 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63  MA;.    }.    rc
34e0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b   = SQLITE_ERROR;
34f0: 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6f 66  .    goto end_of
3500: 5f 73 74 65 70 3b 0a 20 20 7d 0a 20 20 69 66 28  _step;.  }.  if(
3510: 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e   sqlite3SafetyOn
3520: 28 64 62 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72  (db) ){.    p->r
3530: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  c = SQLITE_MISUS
3540: 45 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  E;.    return SQ
3550: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d  LITE_MISUSE;.  }
3560: 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c 30 20 29  .  if( p->pc<0 )
3570: 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72  {.    /* If ther
3580: 65 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 73  e are no other s
3590: 74 61 74 65 6d 65 6e 74 73 20 63 75 72 72 65 6e  tatements curren
35a0: 74 6c 79 20 72 75 6e 6e 69 6e 67 2c 20 74 68 65  tly running, the
35b0: 6e 0a 20 20 20 20 2a 2a 20 72 65 73 65 74 20 74  n.    ** reset t
35c0: 68 65 20 69 6e 74 65 72 72 75 70 74 20 66 6c 61  he interrupt fla
35d0: 67 2e 20 20 54 68 69 73 20 70 72 65 76 65 6e 74  g.  This prevent
35e0: 73 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69  s a call to sqli
35f0: 74 65 33 5f 69 6e 74 65 72 72 75 70 74 0a 20 20  te3_interrupt.  
3600: 20 20 2a 2a 20 66 72 6f 6d 20 69 6e 74 65 72 72    ** from interr
3610: 75 70 74 69 6e 67 20 61 20 73 74 61 74 65 6d 65  upting a stateme
3620: 6e 74 20 74 68 61 74 20 68 61 73 20 6e 6f 74 20  nt that has not 
3630: 79 65 74 20 73 74 61 72 74 65 64 2e 0a 20 20 20  yet started..   
3640: 20 2a 2f 0a 20 20 20 20 69 66 28 20 64 62 2d 3e   */.    if( db->
3650: 61 63 74 69 76 65 56 64 62 65 43 6e 74 3d 3d 30  activeVdbeCnt==0
3660: 20 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 75 31   ){.      db->u1
3670: 2e 69 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d  .isInterrupted =
3680: 20 30 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 6e 64   0;.    }..#ifnd
3690: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  ef SQLITE_OMIT_T
36a0: 52 41 43 45 0a 20 20 20 20 69 66 28 20 64 62 2d  RACE.    if( db-
36b0: 3e 78 50 72 6f 66 69 6c 65 20 26 26 20 21 64 62  >xProfile && !db
36c0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20  ->init.busy ){. 
36d0: 20 20 20 20 20 64 6f 75 62 6c 65 20 72 4e 6f 77       double rNow
36e0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f  ;.      sqlite3O
36f0: 73 43 75 72 72 65 6e 74 54 69 6d 65 28 64 62 2d  sCurrentTime(db-
3700: 3e 70 56 66 73 2c 20 26 72 4e 6f 77 29 3b 0a 20  >pVfs, &rNow);. 
3710: 20 20 20 20 20 70 2d 3e 73 74 61 72 74 54 69 6d       p->startTim
3720: 65 20 3d 20 28 72 4e 6f 77 20 2d 20 28 69 6e 74  e = (rNow - (int
3730: 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32 34  )rNow)*3600.0*24
3740: 2e 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30 3b  .0*1000000000.0;
3750: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20  .    }.#endif.. 
3760: 20 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62     db->activeVdb
3770: 65 43 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d 3e 70  eCnt++;.    p->p
3780: 63 20 3d 20 30 3b 0a 20 20 20 20 73 74 6d 74 4c  c = 0;.    stmtL
3790: 72 75 52 65 6d 6f 76 65 28 70 29 3b 0a 20 20 7d  ruRemove(p);.  }
37a0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
37b0: 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69  OMIT_EXPLAIN.  i
37c0: 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 7b  f( p->explain ){
37d0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
37e0: 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a 20 20  3VdbeList(p);.  
37f0: 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f 2a 20  }else.#endif /* 
3800: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c  SQLITE_OMIT_EXPL
3810: 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 20 72  AIN */.  {.    r
3820: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 45  c = sqlite3VdbeE
3830: 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 20 69  xec(p);.  }..  i
3840: 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79  f( sqlite3Safety
3850: 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72  Off(db) ){.    r
3860: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  c = SQLITE_MISUS
3870: 45 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20  E;.  }..#ifndef 
3880: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43  SQLITE_OMIT_TRAC
3890: 45 0a 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68  E.  /* Invoke th
38a0: 65 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62 61  e profile callba
38b0: 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 20 6f  ck if there is o
38c0: 6e 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63  ne.  */.  if( rc
38d0: 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 26 20  !=SQLITE_ROW && 
38e0: 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 26 26 20  db->xProfile && 
38f0: 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 26  !db->init.busy &
3900: 26 20 70 2d 3e 6e 4f 70 3e 30 0a 20 20 20 20 20  & p->nOp>0.     
3910: 20 20 20 20 20 20 26 26 20 70 2d 3e 61 4f 70 5b        && p->aOp[
3920: 30 5d 2e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 54 72  0].opcode==OP_Tr
3930: 61 63 65 20 26 26 20 70 2d 3e 61 4f 70 5b 30 5d  ace && p->aOp[0]
3940: 2e 70 34 2e 7a 21 3d 30 20 29 7b 0a 20 20 20 20  .p4.z!=0 ){.    
3950: 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20  double rNow;.   
3960: 20 75 36 34 20 65 6c 61 70 73 65 54 69 6d 65 3b   u64 elapseTime;
3970: 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43  ..    sqlite3OsC
3980: 75 72 72 65 6e 74 54 69 6d 65 28 64 62 2d 3e 70  urrentTime(db->p
3990: 56 66 73 2c 20 26 72 4e 6f 77 29 3b 0a 20 20 20  Vfs, &rNow);.   
39a0: 20 65 6c 61 70 73 65 54 69 6d 65 20 3d 20 28 72   elapseTime = (r
39b0: 4e 6f 77 20 2d 20 28 69 6e 74 29 72 4e 6f 77 29  Now - (int)rNow)
39c0: 2a 33 36 30 30 2e 30 2a 32 34 2e 30 2a 31 30 30  *3600.0*24.0*100
39d0: 30 30 30 30 30 30 30 2e 30 20 2d 20 70 2d 3e 73  0000000.0 - p->s
39e0: 74 61 72 74 54 69 6d 65 3b 0a 20 20 20 20 64 62  tartTime;.    db
39f0: 2d 3e 78 50 72 6f 66 69 6c 65 28 64 62 2d 3e 70  ->xProfile(db->p
3a00: 50 72 6f 66 69 6c 65 41 72 67 2c 20 70 2d 3e 61  ProfileArg, p->a
3a10: 4f 70 5b 30 5d 2e 70 34 2e 7a 2c 20 65 6c 61 70  Op[0].p4.z, elap
3a20: 73 65 54 69 6d 65 29 3b 0a 20 20 7d 0a 23 65 6e  seTime);.  }.#en
3a30: 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 72  dif..  sqlite3Er
3a40: 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63 2c 20 30  ror(p->db, rc, 0
3a50: 29 3b 0a 20 20 70 2d 3e 72 63 20 3d 20 73 71 6c  );.  p->rc = sql
3a60: 69 74 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64  ite3ApiExit(p->d
3a70: 62 2c 20 70 2d 3e 72 63 29 3b 0a 65 6e 64 5f 6f  b, p->rc);.end_o
3a80: 66 5f 73 74 65 70 3a 0a 20 20 61 73 73 65 72 74  f_step:.  assert
3a90: 28 20 28 72 63 26 30 78 66 66 29 3d 3d 72 63 20  ( (rc&0xff)==rc 
3aa0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 7a 53 71 6c  );.  if( p->zSql
3ab0: 20 26 26 20 28 72 63 26 30 78 66 66 29 3c 53 51   && (rc&0xff)<SQ
3ac0: 4c 49 54 45 5f 52 4f 57 20 29 7b 0a 20 20 20 20  LITE_ROW ){.    
3ad0: 2f 2a 20 54 68 69 73 20 62 65 68 61 76 69 6f 72  /* This behavior
3ae0: 20 6f 63 63 75 72 73 20 69 66 20 73 71 6c 69 74   occurs if sqlit
3af0: 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29 20  e3_prepare_v2() 
3b00: 77 61 73 20 75 73 65 64 20 74 6f 20 62 75 69 6c  was used to buil
3b10: 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 70 72 65  d.    ** the pre
3b20: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 2e  pared statement.
3b30: 20 20 52 65 74 75 72 6e 20 65 72 72 6f 72 20 63    Return error c
3b40: 6f 64 65 73 20 64 69 72 65 63 74 6c 79 20 2a 2f  odes directly */
3b50: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
3b60: 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20  r(p->db, p->rc, 
3b70: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 70  0);.    return p
3b80: 2d 3e 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  ->rc;.  }else{. 
3b90: 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 66 6f     /* This is fo
3ba0: 72 20 6c 65 67 61 63 79 20 73 71 6c 69 74 65 33  r legacy sqlite3
3bb0: 5f 70 72 65 70 61 72 65 28 29 20 62 75 69 6c 64  _prepare() build
3bc0: 73 20 61 6e 64 20 77 68 65 6e 20 74 68 65 20 63  s and when the c
3bd0: 6f 64 65 0a 20 20 20 20 2a 2a 20 69 73 20 53 51  ode.    ** is SQ
3be0: 4c 49 54 45 5f 52 4f 57 20 6f 72 20 53 51 4c 49  LITE_ROW or SQLI
3bf0: 54 45 5f 44 4f 4e 45 20 2a 2f 0a 20 20 20 20 72  TE_DONE */.    r
3c00: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 7d 0a  eturn rc;.  }.}.
3c10: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  ./*.** This is t
3c20: 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 69 6d 70  he top-level imp
3c30: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73  lementation of s
3c40: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 20 20  qlite3_step().  
3c50: 43 61 6c 6c 0a 2a 2a 20 73 71 6c 69 74 65 33 53  Call.** sqlite3S
3c60: 74 65 70 28 29 20 74 6f 20 64 6f 20 6d 6f 73 74  tep() to do most
3c70: 20 6f 66 20 74 68 65 20 77 6f 72 6b 2e 20 20 49   of the work.  I
3c80: 66 20 61 20 73 63 68 65 6d 61 20 65 72 72 6f 72  f a schema error
3c90: 20 6f 63 63 75 72 73 2c 0a 2a 2a 20 63 61 6c 6c   occurs,.** call
3ca0: 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72   sqlite3Reprepar
3cb0: 65 28 29 20 61 6e 64 20 74 72 79 20 61 67 61 69  e() and try agai
3cc0: 6e 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c  n..*/.#ifdef SQL
3cd0: 49 54 45 5f 4f 4d 49 54 5f 50 41 52 53 45 52 0a  ITE_OMIT_PARSER.
3ce0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 65 70  int sqlite3_step
3cf0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
3d00: 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 63 20  Stmt){.  int rc 
3d10: 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  = SQLITE_MISUSE;
3d20: 0a 20 20 69 66 28 20 70 53 74 6d 74 20 29 7b 0a  .  if( pStmt ){.
3d30: 20 20 20 20 56 64 62 65 20 2a 76 3b 0a 20 20 20      Vdbe *v;.   
3d40: 20 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d   v = (Vdbe*)pStm
3d50: 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  t;.    sqlite3_m
3d60: 75 74 65 78 5f 65 6e 74 65 72 28 76 2d 3e 64 62  utex_enter(v->db
3d70: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 63  ->mutex);.    rc
3d80: 20 3d 20 73 71 6c 69 74 65 33 53 74 65 70 28 76   = sqlite3Step(v
3d90: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
3da0: 75 74 65 78 5f 6c 65 61 76 65 28 76 2d 3e 64 62  utex_leave(v->db
3db0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20  ->mutex);.  }.  
3dc0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6c  return rc;.}.#el
3dd0: 73 65 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73  se.int sqlite3_s
3de0: 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  tep(sqlite3_stmt
3df0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20   *pStmt){.  int 
3e00: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55  rc = SQLITE_MISU
3e10: 53 45 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 20  SE;.  if( pStmt 
3e20: 29 7b 0a 20 20 20 20 69 6e 74 20 63 6e 74 20 3d  ){.    int cnt =
3e30: 20 30 3b 0a 20 20 20 20 56 64 62 65 20 2a 76 20   0;.    Vdbe *v 
3e40: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a  = (Vdbe*)pStmt;.
3e50: 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20      sqlite3 *db 
3e60: 3d 20 76 2d 3e 64 62 3b 0a 20 20 20 20 73 71 6c  = v->db;.    sql
3e70: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
3e80: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20  (db->mutex);.   
3e90: 20 77 68 69 6c 65 28 20 28 72 63 20 3d 20 73 71   while( (rc = sq
3ea0: 6c 69 74 65 33 53 74 65 70 28 76 29 29 3d 3d 53  lite3Step(v))==S
3eb0: 51 4c 49 54 45 5f 53 43 48 45 4d 41 0a 20 20 20  QLITE_SCHEMA.   
3ec0: 20 20 20 20 20 20 20 20 26 26 20 63 6e 74 2b 2b          && cnt++
3ed0: 20 3c 20 35 0a 20 20 20 20 20 20 20 20 20 20 20   < 5.           
3ee0: 26 26 20 76 64 62 65 52 65 70 72 65 70 61 72 65  && vdbeReprepare
3ef0: 28 76 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  (v) ){.      sql
3f00: 69 74 65 33 5f 72 65 73 65 74 28 70 53 74 6d 74  ite3_reset(pStmt
3f10: 29 3b 0a 20 20 20 20 20 20 76 2d 3e 65 78 70 69  );.      v->expi
3f20: 72 65 64 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20  red = 0;.    }. 
3f30: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
3f40: 45 5f 53 43 48 45 4d 41 20 26 26 20 76 2d 3e 7a  E_SCHEMA && v->z
3f50: 53 71 6c 20 26 26 20 64 62 2d 3e 70 45 72 72 20  Sql && db->pErr 
3f60: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73  ){.      /* This
3f70: 20 63 61 73 65 20 6f 63 63 75 72 73 20 61 66 74   case occurs aft
3f80: 65 72 20 66 61 69 6c 69 6e 67 20 74 6f 20 72 65  er failing to re
3f90: 63 6f 6d 70 69 6c 65 20 61 6e 20 73 71 6c 20 73  compile an sql s
3fa0: 74 61 74 65 6d 65 6e 74 2e 20 0a 20 20 20 20 20  tatement. .     
3fb0: 20 2a 2a 20 54 68 65 20 65 72 72 6f 72 20 6d 65   ** The error me
3fc0: 73 73 61 67 65 20 66 72 6f 6d 20 74 68 65 20 53  ssage from the S
3fd0: 51 4c 20 63 6f 6d 70 69 6c 65 72 20 68 61 73 20  QL compiler has 
3fe0: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 6c 6f 61  already been loa
3ff0: 64 65 64 20 0a 20 20 20 20 20 20 2a 2a 20 69 6e  ded .      ** in
4000: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20  to the database 
4010: 68 61 6e 64 6c 65 2e 20 54 68 69 73 20 62 6c 6f  handle. This blo
4020: 63 6b 20 63 6f 70 69 65 73 20 74 68 65 20 65 72  ck copies the er
4030: 72 6f 72 20 6d 65 73 73 61 67 65 20 0a 20 20 20  ror message .   
4040: 20 20 20 2a 2a 20 66 72 6f 6d 20 74 68 65 20 64     ** from the d
4050: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 69  atabase handle i
4060: 6e 74 6f 20 74 68 65 20 73 74 61 74 65 6d 65 6e  nto the statemen
4070: 74 20 61 6e 64 20 73 65 74 73 20 74 68 65 20 73  t and sets the s
4080: 74 61 74 65 6d 65 6e 74 0a 20 20 20 20 20 20 2a  tatement.      *
4090: 2a 20 70 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65  * program counte
40a0: 72 20 74 6f 20 30 20 74 6f 20 65 6e 73 75 72 65  r to 0 to ensure
40b0: 20 74 68 61 74 20 77 68 65 6e 20 74 68 65 20 73   that when the s
40c0: 74 61 74 65 6d 65 6e 74 20 69 73 20 0a 20 20 20  tatement is .   
40d0: 20 20 20 2a 2a 20 66 69 6e 61 6c 69 7a 65 64 20     ** finalized 
40e0: 6f 72 20 72 65 73 65 74 20 74 68 65 20 70 61 72  or reset the par
40f0: 73 65 72 20 65 72 72 6f 72 20 6d 65 73 73 61 67  ser error messag
4100: 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 76  e is available v
4110: 69 61 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69  ia.      ** sqli
4120: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64  te3_errmsg() and
4130: 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65   sqlite3_errcode
4140: 28 29 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20  ()..      */.   
4150: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a     const char *z
4160: 45 72 72 20 3d 20 28 63 6f 6e 73 74 20 63 68 61  Err = (const cha
4170: 72 20 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75  r *)sqlite3_valu
4180: 65 5f 74 65 78 74 28 64 62 2d 3e 70 45 72 72 29  e_text(db->pErr)
4190: 3b 20 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ; .      sqlite3
41a0: 5f 66 72 65 65 28 76 2d 3e 7a 45 72 72 4d 73 67  _free(v->zErrMsg
41b0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 64 62  );.      if( !db
41c0: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29  ->mallocFailed )
41d0: 7b 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72  {.        v->zEr
41e0: 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 44 62  rMsg = sqlite3Db
41f0: 53 74 72 44 75 70 28 64 62 2c 20 7a 45 72 72 29  StrDup(db, zErr)
4200: 3b 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 20 7b  ;.      } else {
4210: 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72 72  .        v->zErr
4220: 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  Msg = 0;.       
4230: 20 76 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   v->rc = SQLITE_
4240: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20  NOMEM;.      }. 
4250: 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71     }.    rc = sq
4260: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c  lite3ApiExit(db,
4270: 20 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 65   rc);.    sqlite
4280: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62  3_mutex_leave(db
4290: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20  ->mutex);.  }.  
42a0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e  return rc;.}.#en
42b0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61  dif../*.** Extra
42c0: 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74 61  ct the user data
42d0: 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 5f   from a sqlite3_
42e0: 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72  context structur
42f0: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a 2a  e and return a.*
4300: 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e  * pointer to it.
4310: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
4320: 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c 69  3_user_data(sqli
4330: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b  te3_context *p){
4340: 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20  .  assert( p && 
4350: 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 65  p->pFunc );.  re
4360: 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e 70  turn p->pFunc->p
4370: 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a  UserData;.}../*.
4380: 2a 2a 20 45 78 74 72 61 63 74 20 74 68 65 20 75  ** Extract the u
4390: 73 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20  ser data from a 
43a0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
43b0: 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 72 65  structure and re
43c0: 74 75 72 6e 20 61 0a 2a 2a 20 70 6f 69 6e 74 65  turn a.** pointe
43d0: 72 20 74 6f 20 69 74 2e 0a 2a 2f 0a 73 71 6c 69  r to it..*/.sqli
43e0: 74 65 33 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6e  te3 *sqlite3_con
43f0: 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 73  text_db_handle(s
4400: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a  qlite3_context *
4410: 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20  p){.  assert( p 
4420: 26 26 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20  && p->pFunc );. 
4430: 20 72 65 74 75 72 6e 20 70 2d 3e 73 2e 64 62 3b   return p->s.db;
4440: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  .}../*.** The fo
4450: 6c 6c 6f 77 69 6e 67 20 69 73 20 74 68 65 20 69  llowing is the i
4460: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
4470: 20 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e   an SQL function
4480: 20 74 68 61 74 20 61 6c 77 61 79 73 0a 2a 2a 20   that always.** 
4490: 66 61 69 6c 73 20 77 69 74 68 20 61 6e 20 65 72  fails with an er
44a0: 72 6f 72 20 6d 65 73 73 61 67 65 20 73 74 61 74  ror message stat
44b0: 69 6e 67 20 74 68 61 74 20 74 68 65 20 66 75 6e  ing that the fun
44c0: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e  ction is used in
44d0: 20 74 68 65 0a 2a 2a 20 77 72 6f 6e 67 20 63 6f   the.** wrong co
44e0: 6e 74 65 78 74 2e 20 20 54 68 65 20 73 71 6c 69  ntext.  The sqli
44f0: 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 6e  te3_overload_fun
4500: 63 74 69 6f 6e 28 29 20 41 50 49 20 6d 69 67 68  ction() API migh
4510: 74 20 63 6f 6e 73 74 72 75 63 74 0a 2a 2a 20 53  t construct.** S
4520: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74  QL function that
4530: 20 75 73 65 20 74 68 69 73 20 72 6f 75 74 69 6e   use this routin
4540: 65 20 73 6f 20 74 68 61 74 20 74 68 65 20 66 75  e so that the fu
4550: 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 65 78 69  nctions will exi
4560: 73 74 0a 2a 2a 20 66 6f 72 20 6e 61 6d 65 20 72  st.** for name r
4570: 65 73 6f 6c 75 74 69 6f 6e 20 62 75 74 20 61 72  esolution but ar
4580: 65 20 61 63 74 75 61 6c 6c 79 20 6f 76 65 72 6c  e actually overl
4590: 6f 61 64 65 64 20 62 79 20 74 68 65 20 78 46 69  oaded by the xFi
45a0: 6e 64 46 75 6e 63 74 69 6f 6e 0a 2a 2a 20 6d 65  ndFunction.** me
45b0: 74 68 6f 64 20 6f 66 20 76 69 72 74 75 61 6c 20  thod of virtual 
45c0: 74 61 62 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20  tables..*/.void 
45d0: 73 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 75  sqlite3InvalidFu
45e0: 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65  nction(.  sqlite
45f0: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65  3_context *conte
4600: 78 74 2c 20 20 2f 2a 20 54 68 65 20 66 75 6e 63  xt,  /* The func
4610: 74 69 6f 6e 20 63 61 6c 6c 69 6e 67 20 63 6f 6e  tion calling con
4620: 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 61 72  text */.  int ar
4630: 67 63 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  gc,             
4640: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
4650: 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 74  f arguments to t
4660: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20  he function */. 
4670: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a   sqlite3_value *
4680: 2a 61 72 67 76 20 20 20 20 20 20 20 2f 2a 20 56  *argv       /* V
4690: 61 6c 75 65 20 6f 66 20 65 61 63 68 20 61 72 67  alue of each arg
46a0: 75 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 63 6f  ument */.){.  co
46b0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 20  nst char *zName 
46c0: 3d 20 63 6f 6e 74 65 78 74 2d 3e 70 46 75 6e 63  = context->pFunc
46d0: 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 63 68 61 72 20  ->zName;.  char 
46e0: 2a 7a 45 72 72 3b 0a 20 20 7a 45 72 72 20 3d 20  *zErr;.  zErr = 
46f0: 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 30  sqlite3MPrintf(0
4700: 2c 0a 20 20 20 20 20 20 22 75 6e 61 62 6c 65 20  ,.      "unable 
4710: 74 6f 20 75 73 65 20 66 75 6e 63 74 69 6f 6e 20  to use function 
4720: 25 73 20 69 6e 20 74 68 65 20 72 65 71 75 65 73  %s in the reques
4730: 74 65 64 20 63 6f 6e 74 65 78 74 22 2c 20 7a 4e  ted context", zN
4740: 61 6d 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  ame);.  sqlite3_
4750: 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 63 6f 6e  result_error(con
4760: 74 65 78 74 2c 20 7a 45 72 72 2c 20 2d 31 29 3b  text, zErr, -1);
4770: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28  .  sqlite3_free(
4780: 7a 45 72 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  zErr);.}../*.** 
4790: 41 6c 6c 6f 63 61 74 65 20 6f 72 20 72 65 74 75  Allocate or retu
47a0: 72 6e 20 74 68 65 20 61 67 67 72 65 67 61 74 65  rn the aggregate
47b0: 20 63 6f 6e 74 65 78 74 20 66 6f 72 20 61 20 75   context for a u
47c0: 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20 20 41  ser function.  A
47d0: 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 65 78 74 20   new.** context 
47e0: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 6f 6e 20  is allocated on 
47f0: 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 2e 20  the first call. 
4800: 20 53 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c   Subsequent call
4810: 73 20 72 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20  s return the.** 
4820: 73 61 6d 65 20 63 6f 6e 74 65 78 74 20 74 68 61  same context tha
4830: 74 20 77 61 73 20 72 65 74 75 72 6e 65 64 20 6f  t was returned o
4840: 6e 20 70 72 69 6f 72 20 63 61 6c 6c 73 2e 0a 2a  n prior calls..*
4850: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
4860: 61 67 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78  aggregate_contex
4870: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  t(sqlite3_contex
4880: 74 20 2a 70 2c 20 69 6e 74 20 6e 42 79 74 65 29  t *p, int nByte)
4890: 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 3b 0a 20  {.  Mem *pMem;. 
48a0: 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d   assert( p && p-
48b0: 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75  >pFunc && p->pFu
48c0: 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 61  nc->xStep );.  a
48d0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
48e0: 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 73 2e 64  utex_held(p->s.d
48f0: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70  b->mutex) );.  p
4900: 4d 65 6d 20 3d 20 70 2d 3e 70 4d 65 6d 3b 0a 20  Mem = p->pMem;. 
4910: 20 69 66 28 20 28 70 4d 65 6d 2d 3e 66 6c 61 67   if( (pMem->flag
4920: 73 20 26 20 4d 45 4d 5f 41 67 67 29 3d 3d 30 20  s & MEM_Agg)==0 
4930: 29 7b 0a 20 20 20 20 69 66 28 20 6e 42 79 74 65  ){.    if( nByte
4940: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  ==0 ){.      sql
4950: 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61  ite3VdbeMemRelea
4960: 73 65 45 78 74 65 72 6e 61 6c 28 70 4d 65 6d 29  seExternal(pMem)
4970: 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  ;.      pMem->fl
4980: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a  ags = MEM_Null;.
4990: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20        pMem->z = 
49a0: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
49b0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
49c0: 65 6d 47 72 6f 77 28 70 4d 65 6d 2c 20 6e 42 79  emGrow(pMem, nBy
49d0: 74 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 4d  te, 0);.      pM
49e0: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
49f0: 41 67 67 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  Agg;.      pMem-
4a00: 3e 75 2e 70 44 65 66 20 3d 20 70 2d 3e 70 46 75  >u.pDef = p->pFu
4a10: 6e 63 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4d  nc;.      if( pM
4a20: 65 6d 2d 3e 7a 20 29 7b 0a 20 20 20 20 20 20 20  em->z ){.       
4a30: 20 6d 65 6d 73 65 74 28 70 4d 65 6d 2d 3e 7a 2c   memset(pMem->z,
4a40: 20 30 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20   0, nByte);.    
4a50: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20    }.    }.  }.  
4a60: 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 70 4d  return (void*)pM
4a70: 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  em->z;.}../*.** 
4a80: 52 65 74 75 72 6e 20 74 68 65 20 61 75 78 69 6c  Return the auxil
4a90: 61 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72  ary data pointer
4aa0: 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72 20 74 68  , if any, for th
4ab0: 65 20 69 41 72 67 27 74 68 20 61 72 67 75 6d 65  e iArg'th argume
4ac0: 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 75 73 65  nt to.** the use
4ad0: 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e  r-function defin
4ae0: 65 64 20 62 79 20 70 43 74 78 2e 0a 2a 2f 0a 76  ed by pCtx..*/.v
4af0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 67 65 74  oid *sqlite3_get
4b00: 5f 61 75 78 64 61 74 61 28 73 71 6c 69 74 65 33  _auxdata(sqlite3
4b10: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20  _context *pCtx, 
4b20: 69 6e 74 20 69 41 72 67 29 7b 0a 20 20 56 64 62  int iArg){.  Vdb
4b30: 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63  eFunc *pVdbeFunc
4b40: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ;..  assert( sql
4b50: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
4b60: 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65  pCtx->s.db->mute
4b70: 78 29 20 29 3b 0a 20 20 70 56 64 62 65 46 75 6e  x) );.  pVdbeFun
4b80: 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 65 46  c = pCtx->pVdbeF
4b90: 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 64 62  unc;.  if( !pVdb
4ba0: 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e 3d 70  eFunc || iArg>=p
4bb0: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 7c  VdbeFunc->nAux |
4bc0: 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20 20 20  | iArg<0 ){.    
4bd0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
4be0: 72 65 74 75 72 6e 20 70 56 64 62 65 46 75 6e 63  return pVdbeFunc
4bf0: 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 2e 70 41  ->apAux[iArg].pA
4c00: 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  ux;.}../*.** Set
4c10: 20 74 68 65 20 61 75 78 69 6c 61 72 79 20 64 61   the auxilary da
4c20: 74 61 20 70 6f 69 6e 74 65 72 20 61 6e 64 20 64  ta pointer and d
4c30: 65 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e 2c 20  elete function, 
4c40: 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 68 0a  for the iArg'th.
4c50: 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74  ** argument to t
4c60: 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e  he user-function
4c70: 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 74 78   defined by pCtx
4c80: 2e 20 41 6e 79 20 70 72 65 76 69 6f 75 73 20 76  . Any previous v
4c90: 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65 6c 65 74  alue is.** delet
4ca0: 65 64 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68  ed by calling th
4cb0: 65 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f  e delete functio
4cc0: 6e 20 73 70 65 63 69 66 69 65 64 20 77 68 65 6e  n specified when
4cd0: 20 69 74 20 77 61 73 20 73 65 74 2e 0a 2a 2f 0a   it was set..*/.
4ce0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 65 74  void sqlite3_set
4cf0: 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71 6c 69  _auxdata(.  sqli
4d00: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
4d10: 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67 2c 20  x, .  int iArg, 
4d20: 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20 0a  .  void *pAux, .
4d30: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 74 65    void (*xDelete
4d40: 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 73 74  )(void*).){.  st
4d50: 72 75 63 74 20 41 75 78 44 61 74 61 20 2a 70 41  ruct AuxData *pA
4d60: 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65 46 75  uxData;.  VdbeFu
4d70: 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 3b 0a 20  nc *pVdbeFunc;. 
4d80: 20 69 66 28 20 69 41 72 67 3c 30 20 29 20 67 6f   if( iArg<0 ) go
4d90: 74 6f 20 66 61 69 6c 65 64 3b 0a 0a 20 20 61 73  to failed;..  as
4da0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
4db0: 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73  tex_held(pCtx->s
4dc0: 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  .db->mutex) );. 
4dd0: 20 70 56 64 62 65 46 75 6e 63 20 3d 20 70 43 74   pVdbeFunc = pCt
4de0: 78 2d 3e 70 56 64 62 65 46 75 6e 63 3b 0a 20 20  x->pVdbeFunc;.  
4df0: 69 66 28 20 21 70 56 64 62 65 46 75 6e 63 20 7c  if( !pVdbeFunc |
4e00: 7c 20 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75  | pVdbeFunc->nAu
4e10: 78 3c 3d 69 41 72 67 20 29 7b 0a 20 20 20 20 69  x<=iArg ){.    i
4e20: 6e 74 20 6e 41 75 78 20 3d 20 28 70 56 64 62 65  nt nAux = (pVdbe
4e30: 46 75 6e 63 20 3f 20 70 56 64 62 65 46 75 6e 63  Func ? pVdbeFunc
4e40: 2d 3e 6e 41 75 78 20 3a 20 30 29 3b 0a 20 20 20  ->nAux : 0);.   
4e50: 20 69 6e 74 20 6e 4d 61 6c 6c 6f 63 20 3d 20 73   int nMalloc = s
4e60: 69 7a 65 6f 66 28 56 64 62 65 46 75 6e 63 29 20  izeof(VdbeFunc) 
4e70: 2b 20 73 69 7a 65 6f 66 28 73 74 72 75 63 74 20  + sizeof(struct 
4e80: 41 75 78 44 61 74 61 29 2a 69 41 72 67 3b 0a 20  AuxData)*iArg;. 
4e90: 20 20 20 70 56 64 62 65 46 75 6e 63 20 3d 20 73     pVdbeFunc = s
4ea0: 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28  qlite3DbRealloc(
4eb0: 70 43 74 78 2d 3e 73 2e 64 62 2c 20 70 56 64 62  pCtx->s.db, pVdb
4ec0: 65 46 75 6e 63 2c 20 6e 4d 61 6c 6c 6f 63 29 3b  eFunc, nMalloc);
4ed0: 0a 20 20 20 20 69 66 28 20 21 70 56 64 62 65 46  .    if( !pVdbeF
4ee0: 75 6e 63 20 29 7b 0a 20 20 20 20 20 20 67 6f 74  unc ){.      got
4ef0: 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a  o failed;.    }.
4f00: 20 20 20 20 70 43 74 78 2d 3e 70 56 64 62 65 46      pCtx->pVdbeF
4f10: 75 6e 63 20 3d 20 70 56 64 62 65 46 75 6e 63 3b  unc = pVdbeFunc;
4f20: 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 70 56 64  .    memset(&pVd
4f30: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 6e 41  beFunc->apAux[nA
4f40: 75 78 5d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  ux], 0, sizeof(s
4f50: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 28  truct AuxData)*(
4f60: 69 41 72 67 2b 31 2d 6e 41 75 78 29 29 3b 0a 20  iArg+1-nAux));. 
4f70: 20 20 20 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41     pVdbeFunc->nA
4f80: 75 78 20 3d 20 69 41 72 67 2b 31 3b 0a 20 20 20  ux = iArg+1;.   
4f90: 20 70 56 64 62 65 46 75 6e 63 2d 3e 70 46 75 6e   pVdbeFunc->pFun
4fa0: 63 20 3d 20 70 43 74 78 2d 3e 70 46 75 6e 63 3b  c = pCtx->pFunc;
4fb0: 0a 20 20 7d 0a 0a 20 20 70 41 75 78 44 61 74 61  .  }..  pAuxData
4fc0: 20 3d 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61   = &pVdbeFunc->a
4fd0: 70 41 75 78 5b 69 41 72 67 5d 3b 0a 20 20 69 66  pAux[iArg];.  if
4fe0: 28 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78  ( pAuxData->pAux
4ff0: 20 26 26 20 70 41 75 78 44 61 74 61 2d 3e 78 44   && pAuxData->xD
5000: 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 70 41 75  elete ){.    pAu
5010: 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 28 70  xData->xDelete(p
5020: 41 75 78 44 61 74 61 2d 3e 70 41 75 78 29 3b 0a  AuxData->pAux);.
5030: 20 20 7d 0a 20 20 70 41 75 78 44 61 74 61 2d 3e    }.  pAuxData->
5040: 70 41 75 78 20 3d 20 70 41 75 78 3b 0a 20 20 70  pAux = pAux;.  p
5050: 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65  AuxData->xDelete
5060: 20 3d 20 78 44 65 6c 65 74 65 3b 0a 20 20 72 65   = xDelete;.  re
5070: 74 75 72 6e 3b 0a 0a 66 61 69 6c 65 64 3a 0a 20  turn;..failed:. 
5080: 20 69 66 28 20 78 44 65 6c 65 74 65 20 29 7b 0a   if( xDelete ){.
5090: 20 20 20 20 78 44 65 6c 65 74 65 28 70 41 75 78      xDelete(pAux
50a0: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
50b0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
50c0: 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65 20 53  r of times the S
50d0: 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20  tep function of 
50e0: 61 20 61 67 67 72 65 67 61 74 65 20 68 61 73 20  a aggregate has 
50f0: 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e  been .** called.
5100: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  .**.** This func
5110: 74 69 6f 6e 20 69 73 20 64 65 70 72 65 63 61 74  tion is deprecat
5120: 65 64 2e 20 20 44 6f 20 6e 6f 74 20 75 73 65 20  ed.  Do not use 
5130: 69 74 20 66 6f 72 20 6e 65 77 20 63 6f 64 65 2e  it for new code.
5140: 20 20 49 74 20 69 73 0a 2a 2a 20 70 72 6f 76 69    It is.** provi
5150: 64 65 20 6f 6e 6c 79 20 74 6f 20 61 76 6f 69 64  de only to avoid
5160: 20 62 72 65 61 6b 69 6e 67 20 6c 65 67 61 63 79   breaking legacy
5170: 20 63 6f 64 65 2e 20 20 4e 65 77 20 61 67 67 72   code.  New aggr
5180: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 0a 2a  egate function.*
5190: 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  * implementation
51a0: 73 20 73 68 6f 75 6c 64 20 6b 65 65 70 20 74 68  s should keep th
51b0: 65 69 72 20 6f 77 6e 20 63 6f 75 6e 74 73 20 77  eir own counts w
51c0: 69 74 68 69 6e 20 74 68 65 69 72 20 61 67 67 72  ithin their aggr
51d0: 65 67 61 74 65 0a 2a 2a 20 63 6f 6e 74 65 78 74  egate.** context
51e0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
51f0: 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 75 6e 74  _aggregate_count
5200: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
5210: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
5220: 70 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26  p && p->pFunc &&
5230: 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74 65 70   p->pFunc->xStep
5240: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e   );.  return p->
5250: 70 4d 65 6d 2d 3e 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a  pMem->n;.}../*.*
5260: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
5270: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
5280: 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74  n the result set
5290: 20 66 6f 72 20 74 68 65 20 73 74 61 74 65 6d 65   for the stateme
52a0: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74  nt pStmt..*/.int
52b0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
52c0: 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74  count(sqlite3_st
52d0: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64  mt *pStmt){.  Vd
52e0: 62 65 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20  be *pVm = (Vdbe 
52f0: 2a 29 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72  *)pStmt;.  retur
5300: 6e 20 70 56 6d 20 3f 20 70 56 6d 2d 3e 6e 52 65  n pVm ? pVm->nRe
5310: 73 43 6f 6c 75 6d 6e 20 3a 20 30 3b 0a 7d 0a 0a  sColumn : 0;.}..
5320: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
5330: 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65   number of value
5340: 73 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d  s available from
5350: 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77   the current row
5360: 20 6f 66 20 74 68 65 0a 2a 2a 20 63 75 72 72 65   of the.** curre
5370: 6e 74 6c 79 20 65 78 65 63 75 74 69 6e 67 20 73  ntly executing s
5380: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a  tatement pStmt..
5390: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64  */.int sqlite3_d
53a0: 61 74 61 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65  ata_count(sqlite
53b0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a  3_stmt *pStmt){.
53c0: 20 20 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56    Vdbe *pVm = (V
53d0: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69  dbe *)pStmt;.  i
53e0: 66 28 20 70 56 6d 3d 3d 30 20 7c 7c 20 70 56 6d  f( pVm==0 || pVm
53f0: 2d 3e 70 52 65 73 75 6c 74 53 65 74 3d 3d 30 20  ->pResultSet==0 
5400: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65  ) return 0;.  re
5410: 74 75 72 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f  turn pVm->nResCo
5420: 6c 75 6d 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  lumn;.}.../*.** 
5430: 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20  Check to see if 
5440: 63 6f 6c 75 6d 6e 20 69 43 6f 6c 20 6f 66 20 74  column iCol of t
5450: 68 65 20 67 69 76 65 6e 20 73 74 61 74 65 6d 65  he given stateme
5460: 6e 74 20 69 73 20 76 61 6c 69 64 2e 20 20 49 66  nt is valid.  If
5470: 0a 2a 2a 20 69 74 20 69 73 2c 20 72 65 74 75 72  .** it is, retur
5480: 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  n a pointer to t
5490: 68 65 20 4d 65 6d 20 66 6f 72 20 74 68 65 20 76  he Mem for the v
54a0: 61 6c 75 65 20 6f 66 20 74 68 61 74 20 63 6f 6c  alue of that col
54b0: 75 6d 6e 2e 0a 2a 2a 20 49 66 20 69 43 6f 6c 20  umn..** If iCol 
54c0: 69 73 20 6e 6f 74 20 76 61 6c 69 64 2c 20 72 65  is not valid, re
54d0: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74  turn a pointer t
54e0: 6f 20 61 20 4d 65 6d 20 77 68 69 63 68 20 68 61  o a Mem which ha
54f0: 73 20 61 20 76 61 6c 75 65 0a 2a 2a 20 6f 66 20  s a value.** of 
5500: 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  NULL..*/.static 
5510: 4d 65 6d 20 2a 63 6f 6c 75 6d 6e 4d 65 6d 28 73  Mem *columnMem(s
5520: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
5530: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 56 64  mt, int i){.  Vd
5540: 62 65 20 2a 70 56 6d 3b 0a 20 20 69 6e 74 20 76  be *pVm;.  int v
5550: 61 6c 73 3b 0a 20 20 4d 65 6d 20 2a 70 4f 75 74  als;.  Mem *pOut
5560: 3b 0a 0a 20 20 70 56 6d 20 3d 20 28 56 64 62 65  ;..  pVm = (Vdbe
5570: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 20   *)pStmt;.  if( 
5580: 70 56 6d 20 26 26 20 70 56 6d 2d 3e 70 52 65 73  pVm && pVm->pRes
5590: 75 6c 74 53 65 74 21 3d 30 20 26 26 20 69 3c 70  ultSet!=0 && i<p
55a0: 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 26  Vm->nResColumn &
55b0: 26 20 69 3e 3d 30 20 29 7b 0a 20 20 20 20 73 71  & i>=0 ){.    sq
55c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
55d0: 72 28 70 56 6d 2d 3e 64 62 2d 3e 6d 75 74 65 78  r(pVm->db->mutex
55e0: 29 3b 0a 20 20 20 20 76 61 6c 73 20 3d 20 73 71  );.    vals = sq
55f0: 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74  lite3_data_count
5600: 28 70 53 74 6d 74 29 3b 0a 20 20 20 20 70 4f 75  (pStmt);.    pOu
5610: 74 20 3d 20 26 70 56 6d 2d 3e 70 52 65 73 75 6c  t = &pVm->pResul
5620: 74 53 65 74 5b 69 5d 3b 0a 20 20 7d 65 6c 73 65  tSet[i];.  }else
5630: 7b 0a 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e  {.    static con
5640: 73 74 20 4d 65 6d 20 6e 75 6c 6c 4d 65 6d 20 3d  st Mem nullMem =
5650: 20 7b 7b 30 7d 2c 20 30 2e 30 2c 20 30 2c 20 22   {{0}, 0.0, 0, "
5660: 22 2c 20 30 2c 20 4d 45 4d 5f 4e 75 6c 6c 2c 20  ", 0, MEM_Null, 
5670: 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 30 2c 20  SQLITE_NULL, 0, 
5680: 30 2c 20 30 20 7d 3b 0a 20 20 20 20 69 66 28 20  0, 0 };.    if( 
5690: 70 56 6d 2d 3e 64 62 20 29 7b 0a 20 20 20 20 20  pVm->db ){.     
56a0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
56b0: 6e 74 65 72 28 70 56 6d 2d 3e 64 62 2d 3e 6d 75  nter(pVm->db->mu
56c0: 74 65 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  tex);.      sqli
56d0: 74 65 33 45 72 72 6f 72 28 70 56 6d 2d 3e 64 62  te3Error(pVm->db
56e0: 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20  , SQLITE_RANGE, 
56f0: 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4f  0);.    }.    pO
5700: 75 74 20 3d 20 28 4d 65 6d 2a 29 26 6e 75 6c 6c  ut = (Mem*)&null
5710: 4d 65 6d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  Mem;.  }.  retur
5720: 6e 20 70 4f 75 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  n pOut;.}../*.**
5730: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
5740: 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 20 69  s called after i
5750: 6e 76 6f 6b 69 6e 67 20 61 6e 20 73 71 6c 69 74  nvoking an sqlit
5760: 65 33 5f 76 61 6c 75 65 5f 58 58 58 20 66 75 6e  e3_value_XXX fun
5770: 63 74 69 6f 6e 20 6f 6e 20 61 20 0a 2a 2a 20 63  ction on a .** c
5780: 6f 6c 75 6d 6e 20 76 61 6c 75 65 20 28 69 2e 65  olumn value (i.e
5790: 2e 20 61 20 76 61 6c 75 65 20 72 65 74 75 72 6e  . a value return
57a0: 65 64 20 62 79 20 65 76 61 6c 75 61 74 69 6e 67  ed by evaluating
57b0: 20 61 6e 20 53 51 4c 20 65 78 70 72 65 73 73 69   an SQL expressi
57c0: 6f 6e 20 69 6e 20 74 68 65 0a 2a 2a 20 73 65 6c  on in the.** sel
57d0: 65 63 74 20 6c 69 73 74 20 6f 66 20 61 20 53 45  ect list of a SE
57e0: 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 29 20  LECT statement) 
57f0: 74 68 61 74 20 6d 61 79 20 63 61 75 73 65 20 61  that may cause a
5800: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72   malloc() failur
5810: 65 2e 20 49 66 20 0a 2a 2a 20 6d 61 6c 6c 6f 63  e. If .** malloc
5820: 28 29 20 68 61 73 20 66 61 69 6c 65 64 2c 20 74  () has failed, t
5830: 68 65 20 74 68 72 65 61 64 73 20 6d 61 6c 6c 6f  he threads mallo
5840: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 73 20  cFailed flag is 
5850: 63 6c 65 61 72 65 64 20 61 6e 64 20 74 68 65 20  cleared and the 
5860: 72 65 73 75 6c 74 0a 2a 2a 20 63 6f 64 65 20 6f  result.** code o
5870: 66 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  f statement pStm
5880: 74 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f  t set to SQLITE_
5890: 4e 4f 4d 45 4d 2e 0a 2a 2a 0a 2a 2a 20 53 70 65  NOMEM..**.** Spe
58a0: 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 20  cifically, this 
58b0: 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77  is called from w
58c0: 69 74 68 69 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  ithin:.**.**    
58d0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
58e0: 69 6e 74 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c  int().**     sql
58f0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36  ite3_column_int6
5900: 34 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74  4().**     sqlit
5910: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 29  e3_column_text()
5920: 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f  .**     sqlite3_
5930: 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 0a  column_text16().
5940: 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63  **     sqlite3_c
5950: 6f 6c 75 6d 6e 5f 72 65 61 6c 28 29 0a 2a 2a 20  olumn_real().** 
5960: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75      sqlite3_colu
5970: 6d 6e 5f 62 79 74 65 73 28 29 0a 2a 2a 20 20 20  mn_bytes().**   
5980: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e    sqlite3_column
5990: 5f 62 79 74 65 73 31 36 28 29 0a 2a 2a 0a 2a 2a  _bytes16().**.**
59a0: 20 42 75 74 20 6e 6f 74 20 66 6f 72 20 73 71 6c   But not for sql
59b0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62  ite3_column_blob
59c0: 28 29 2c 20 77 68 69 63 68 20 6e 65 76 65 72 20  (), which never 
59d0: 63 61 6c 6c 73 20 6d 61 6c 6c 6f 63 28 29 2e 0a  calls malloc()..
59e0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63  */.static void c
59f0: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75  olumnMallocFailu
5a00: 72 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  re(sqlite3_stmt 
5a10: 2a 70 53 74 6d 74 29 0a 7b 0a 20 20 2f 2a 20 49  *pStmt).{.  /* I
5a20: 66 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65  f malloc() faile
5a30: 64 20 64 75 72 69 6e 67 20 61 6e 20 65 6e 63 6f  d during an enco
5a40: 64 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e 20  ding conversion 
5a50: 77 69 74 68 69 6e 20 61 6e 0a 20 20 2a 2a 20 73  within an.  ** s
5a60: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 58 58  qlite3_column_XX
5a70: 58 20 41 50 49 2c 20 74 68 65 6e 20 73 65 74 20  X API, then set 
5a80: 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20  the return code 
5a90: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  of the statement
5aa0: 20 74 6f 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f   to.  ** SQLITE_
5ab0: 4e 4f 4d 45 4d 2e 20 54 68 65 20 6e 65 78 74 20  NOMEM. The next 
5ac0: 63 61 6c 6c 20 74 6f 20 5f 73 74 65 70 28 29 20  call to _step() 
5ad0: 28 69 66 20 61 6e 79 29 20 77 69 6c 6c 20 72 65  (if any) will re
5ae0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  turn SQLITE_ERRO
5af0: 52 0a 20 20 2a 2a 20 61 6e 64 20 5f 66 69 6e 61  R.  ** and _fina
5b00: 6c 69 7a 65 28 29 20 77 69 6c 6c 20 72 65 74 75  lize() will retu
5b10: 72 6e 20 4e 4f 4d 45 4d 2e 0a 20 20 2a 2f 0a 20  rn NOMEM..  */. 
5b20: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
5b30: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 20   *)pStmt;.  if( 
5b40: 70 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  p ){.    p->rc =
5b50: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
5b60: 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 29 3b 0a 20  p->db, p->rc);. 
5b70: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
5b80: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75  _leave(p->db->mu
5b90: 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a  tex);.  }.}../**
5ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5bb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74  ********** sqlit
5bc0: 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a  e3_column_  ****
5bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5be0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54  ***********.** T
5bf0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75  he following rou
5c00: 74 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74  tines are used t
5c10: 6f 20 61 63 63 65 73 73 20 65 6c 65 6d 65 6e 74  o access element
5c20: 73 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74  s of the current
5c30: 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72   row.** in the r
5c40: 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f  esult set..*/.co
5c50: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
5c60: 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71  3_column_blob(sq
5c70: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
5c80: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e  t, int i){.  con
5c90: 73 74 20 76 6f 69 64 20 2a 76 61 6c 3b 0a 20 20  st void *val;.  
5ca0: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  val = sqlite3_va
5cb0: 6c 75 65 5f 62 6c 6f 62 28 20 63 6f 6c 75 6d 6e  lue_blob( column
5cc0: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
5cd0: 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67 68    /* Even though
5ce0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 65 6e 63   there is no enc
5cf0: 6f 64 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e  oding conversion
5d00: 2c 20 76 61 6c 75 65 5f 62 6c 6f 62 28 29 20 6d  , value_blob() m
5d10: 69 67 68 74 0a 20 20 2a 2a 20 6e 65 65 64 20 74  ight.  ** need t
5d20: 6f 20 63 61 6c 6c 20 6d 61 6c 6c 6f 63 28 29 20  o call malloc() 
5d30: 74 6f 20 65 78 70 61 6e 64 20 74 68 65 20 72 65  to expand the re
5d40: 73 75 6c 74 20 6f 66 20 61 20 7a 65 72 6f 62 6c  sult of a zerobl
5d50: 6f 62 28 29 20 0a 20 20 2a 2a 20 65 78 70 72 65  ob() .  ** expre
5d60: 73 73 69 6f 6e 2e 20 0a 20 20 2a 2f 0a 20 20 63  ssion. .  */.  c
5d70: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75  olumnMallocFailu
5d80: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74  re(pStmt);.  ret
5d90: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73  urn val;.}.int s
5da0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79  qlite3_column_by
5db0: 74 65 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  tes(sqlite3_stmt
5dc0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
5dd0: 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c  .  int val = sql
5de0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73  ite3_value_bytes
5df0: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d  ( columnMem(pStm
5e00: 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e  t,i) );.  column
5e10: 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53  MallocFailure(pS
5e20: 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76  tmt);.  return v
5e30: 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  al;.}.int sqlite
5e40: 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36  3_column_bytes16
5e50: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
5e60: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
5e70: 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c 69 74 65  int val = sqlite
5e80: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28  3_value_bytes16(
5e90: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
5ea0: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d  ,i) );.  columnM
5eb0: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74  allocFailure(pSt
5ec0: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61  mt);.  return va
5ed0: 6c 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73 71 6c 69  l;.}.double sqli
5ee0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c  te3_column_doubl
5ef0: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
5f00: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
5f10: 20 64 6f 75 62 6c 65 20 76 61 6c 20 3d 20 73 71   double val = sq
5f20: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62  lite3_value_doub
5f30: 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  le( columnMem(pS
5f40: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75  tmt,i) );.  colu
5f50: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28  mnMallocFailure(
5f60: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
5f70: 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69   val;.}.int sqli
5f80: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 73  te3_column_int(s
5f90: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
5fa0: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e  mt, int i){.  in
5fb0: 74 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f  t val = sqlite3_
5fc0: 76 61 6c 75 65 5f 69 6e 74 28 20 63 6f 6c 75 6d  value_int( colum
5fd0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
5fe0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
5ff0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
6000: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 73   return val;.}.s
6010: 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69  qlite_int64 sqli
6020: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34  te3_column_int64
6030: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
6040: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20  Stmt, int i){.  
6050: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 76 61 6c  sqlite_int64 val
6060: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
6070: 5f 69 6e 74 36 34 28 20 63 6f 6c 75 6d 6e 4d 65  _int64( columnMe
6080: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20  m(pStmt,i) );.  
6090: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c  columnMallocFail
60a0: 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65  ure(pStmt);.  re
60b0: 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 63 6f 6e 73  turn val;.}.cons
60c0: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
60d0: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
60e0: 74 65 78 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  text(sqlite3_stm
60f0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
6100: 7b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  {.  const unsign
6110: 65 64 20 63 68 61 72 20 2a 76 61 6c 20 3d 20 73  ed char *val = s
6120: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
6130: 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  t( columnMem(pSt
6140: 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d  mt,i) );.  colum
6150: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70  nMallocFailure(p
6160: 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20  Stmt);.  return 
6170: 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65 33 5f 76  val;.}.sqlite3_v
6180: 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f 63 6f  alue *sqlite3_co
6190: 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71 6c 69 74  lumn_value(sqlit
61a0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
61b0: 69 6e 74 20 69 29 7b 0a 20 20 73 71 6c 69 74 65  int i){.  sqlite
61c0: 33 5f 76 61 6c 75 65 20 2a 70 4f 75 74 20 3d 20  3_value *pOut = 
61d0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c  columnMem(pStmt,
61e0: 20 69 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c   i);.  columnMal
61f0: 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74  locFailure(pStmt
6200: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 75 74  );.  return pOut
6210: 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  ;.}.#ifndef SQLI
6220: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f  TE_OMIT_UTF16.co
6230: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65  nst void *sqlite
6240: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28  3_column_text16(
6250: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
6260: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63  tmt, int i){.  c
6270: 6f 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c 20 3d  onst void *val =
6280: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
6290: 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d  ext16( columnMem
62a0: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63  (pStmt,i) );.  c
62b0: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75  olumnMallocFailu
62c0: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74  re(pStmt);.  ret
62d0: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 23 65 6e 64 69  urn val;.}.#endi
62e0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
62f0: 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20 73 71  _UTF16 */.int sq
6300: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70  lite3_column_typ
6310: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
6320: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
6330: 20 69 6e 74 20 69 54 79 70 65 20 3d 20 73 71 6c   int iType = sql
6340: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28  ite3_value_type(
6350: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
6360: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d  ,i) );.  columnM
6370: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74  allocFailure(pSt
6380: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 69 54  mt);.  return iT
6390: 79 70 65 3b 0a 7d 0a 0a 2f 2a 20 54 68 65 20 66  ype;.}../* The f
63a0: 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 6f  ollowing functio
63b0: 6e 20 69 73 20 65 78 70 65 72 69 6d 65 6e 74 61  n is experimenta
63c0: 6c 20 61 6e 64 20 73 75 62 6a 65 63 74 20 74 6f  l and subject to
63d0: 20 63 68 61 6e 67 65 20 6f 72 0a 2a 2a 20 72 65   change or.** re
63e0: 6d 6f 76 61 6c 20 2a 2f 0a 2f 2a 69 6e 74 20 73  moval */./*int s
63f0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 75  qlite3_column_nu
6400: 6d 65 72 69 63 5f 74 79 70 65 28 73 71 6c 69 74  meric_type(sqlit
6410: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
6420: 69 6e 74 20 69 29 7b 0a 2a 2a 20 20 72 65 74 75  int i){.**  retu
6430: 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  rn sqlite3_value
6440: 5f 6e 75 6d 65 72 69 63 5f 74 79 70 65 28 20 63  _numeric_type( c
6450: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
6460: 29 20 29 3b 0a 2a 2a 7d 0a 2a 2f 0a 0a 2f 2a 0a  ) );.**}.*/../*.
6470: 2a 2a 20 43 6f 6e 76 65 72 74 20 74 68 65 20 4e  ** Convert the N
6480: 2d 74 68 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70  -th element of p
6490: 53 74 6d 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d  Stmt->pColName[]
64a0: 20 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 75   into a string u
64b0: 73 69 6e 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20  sing.** xFunc() 
64c0: 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 61 74  then return that
64d0: 20 73 74 72 69 6e 67 2e 20 20 49 66 20 4e 20 69   string.  If N i
64e0: 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20  s out of range, 
64f0: 72 65 74 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20  return 0..**.** 
6500: 54 68 65 72 65 20 61 72 65 20 75 70 20 74 6f 20  There are up to 
6510: 35 20 6e 61 6d 65 73 20 66 6f 72 20 65 61 63 68  5 names for each
6520: 20 63 6f 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70   column.  useTyp
6530: 65 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 69  e determines whi
6540: 63 68 0a 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65  ch.** name is re
6550: 74 75 72 6e 65 64 2e 20 20 48 65 72 65 20 61 72  turned.  Here ar
6560: 65 20 74 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a  e the names:.**.
6570: 2a 2a 20 20 20 20 30 20 20 20 20 20 20 54 68 65  **    0      The
6580: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20   column name as 
6590: 69 74 20 73 68 6f 75 6c 64 20 62 65 20 64 69 73  it should be dis
65a0: 70 6c 61 79 65 64 20 66 6f 72 20 6f 75 74 70 75  played for outpu
65b0: 74 0a 2a 2a 20 20 20 20 31 20 20 20 20 20 20 54  t.**    1      T
65c0: 68 65 20 64 61 74 61 74 79 70 65 20 6e 61 6d 65  he datatype name
65d0: 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a   for the column.
65e0: 2a 2a 20 20 20 20 32 20 20 20 20 20 20 54 68 65  **    2      The
65f0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74   name of the dat
6600: 61 62 61 73 65 20 74 68 61 74 20 74 68 65 20 63  abase that the c
6610: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72  olumn derives fr
6620: 6f 6d 0a 2a 2a 20 20 20 20 33 20 20 20 20 20 20  om.**    3      
6630: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
6640: 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 63  table that the c
6650: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72  olumn derives fr
6660: 6f 6d 0a 2a 2a 20 20 20 20 34 20 20 20 20 20 20  om.**    4      
6670: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
6680: 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61  table column tha
6690: 74 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c  t the result col
66a0: 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d  umn derives from
66b0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65  .**.** If the re
66c0: 73 75 6c 74 20 69 73 20 6e 6f 74 20 61 20 73 69  sult is not a si
66d0: 6d 70 6c 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65  mple column refe
66e0: 72 65 6e 63 65 20 28 69 66 20 69 74 20 69 73 20  rence (if it is 
66f0: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a  an expression.**
6700: 20 6f 72 20 61 20 63 6f 6e 73 74 61 6e 74 29 20   or a constant) 
6710: 74 68 65 6e 20 75 73 65 54 79 70 65 73 20 32 2c  then useTypes 2,
6720: 20 33 2c 20 61 6e 64 20 34 20 72 65 74 75 72 6e   3, and 4 return
6730: 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63   NULL..*/.static
6740: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c   const void *col
6750: 75 6d 6e 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74  umnName(.  sqlit
6760: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a  e3_stmt *pStmt,.
6770: 20 20 69 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74    int N,.  const
6780: 20 76 6f 69 64 20 2a 28 2a 78 46 75 6e 63 29 28   void *(*xFunc)(
6790: 4d 65 6d 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65  Mem*),.  int use
67a0: 54 79 70 65 0a 29 7b 0a 20 20 63 6f 6e 73 74 20  Type.){.  const 
67b0: 76 6f 69 64 20 2a 72 65 74 20 3d 20 30 3b 0a 20  void *ret = 0;. 
67c0: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
67d0: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20   *)pStmt;.  int 
67e0: 6e 3b 0a 20 20 0a 0a 20 20 69 66 28 20 70 21 3d  n;.  ..  if( p!=
67f0: 30 20 29 7b 0a 20 20 20 20 6e 20 3d 20 73 71 6c  0 ){.    n = sql
6800: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e  ite3_column_coun
6810: 74 28 70 53 74 6d 74 29 3b 0a 20 20 20 20 69 66  t(pStmt);.    if
6820: 28 20 4e 3c 6e 20 26 26 20 4e 3e 3d 30 20 29 7b  ( N<n && N>=0 ){
6830: 0a 20 20 20 20 20 20 4e 20 2b 3d 20 75 73 65 54  .      N += useT
6840: 79 70 65 2a 6e 3b 0a 20 20 20 20 20 20 73 71 6c  ype*n;.      sql
6850: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
6860: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
6870: 20 20 20 20 20 20 72 65 74 20 3d 20 78 46 75 6e        ret = xFun
6880: 63 28 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e  c(&p->aColName[N
6890: 5d 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 41 20  ]);..      /* A 
68a0: 6d 61 6c 6c 6f 63 20 6d 61 79 20 68 61 76 65 20  malloc may have 
68b0: 66 61 69 6c 65 64 20 69 6e 73 69 64 65 20 6f 66  failed inside of
68c0: 20 74 68 65 20 78 46 75 6e 63 28 29 20 63 61 6c   the xFunc() cal
68d0: 6c 2e 20 49 66 20 74 68 69 73 0a 20 20 20 20 20  l. If this.     
68e0: 20 2a 2a 20 69 73 20 74 68 65 20 63 61 73 65 2c   ** is the case,
68f0: 20 63 6c 65 61 72 20 74 68 65 20 6d 61 6c 6c 6f   clear the mallo
6900: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 61 6e 64  cFailed flag and
6910: 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 20 20   return NULL..  
6920: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28      */.      if(
6930: 20 70 2d 3e 64 62 20 26 26 20 70 2d 3e 64 62 2d   p->db && p->db-
6940: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b  >mallocFailed ){
6950: 0a 20 20 20 20 20 20 20 20 70 2d 3e 64 62 2d 3e  .        p->db->
6960: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30  mallocFailed = 0
6970: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 20 3d 20  ;.        ret = 
6980: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  0;.      }.     
6990: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
69a0: 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65  eave(p->db->mute
69b0: 78 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  x);.    }.  }.  
69c0: 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f  return ret;.}../
69d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
69e0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68 20  name of the Nth 
69f0: 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65  column of the re
6a00: 73 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e 65  sult set returne
6a10: 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74  d by SQL.** stat
6a20: 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a  ement pStmt..*/.
6a30: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69  const char *sqli
6a40: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28  te3_column_name(
6a50: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
6a60: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
6a70: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
6a80: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e  (.      pStmt, N
6a90: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a  , (const void*(*
6aa0: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f  )(Mem*))sqlite3_
6ab0: 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e  value_text, COLN
6ac0: 41 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 69 66  AME_NAME);.}.#if
6ad0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
6ae0: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69  _UTF16.const voi
6af0: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  d *sqlite3_colum
6b00: 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33  n_name16(sqlite3
6b10: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
6b20: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63  t N){.  return c
6b30: 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20  olumnName(.     
6b40: 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73   pStmt, N, (cons
6b50: 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29  t void*(*)(Mem*)
6b60: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  )sqlite3_value_t
6b70: 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 4e  ext16, COLNAME_N
6b80: 41 4d 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a  AME);.}.#endif..
6b90: 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 72 61 69 6e 74  /*.** Constraint
6ba0: 3a 20 20 49 66 20 79 6f 75 20 68 61 76 65 20 45  :  If you have E
6bb0: 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54  NABLE_COLUMN_MET
6bc0: 41 44 41 54 41 20 74 68 65 6e 20 79 6f 75 20 6d  ADATA then you m
6bd0: 75 73 74 0a 2a 2a 20 6e 6f 74 20 64 65 66 69 6e  ust.** not defin
6be0: 65 20 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45 2e  e OMIT_DECLTYPE.
6bf0: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28  .*/.#if defined(
6c00: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c  SQLITE_OMIT_DECL
6c10: 54 59 50 45 29 20 26 26 20 64 65 66 69 6e 65 64  TYPE) && defined
6c20: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43  (SQLITE_ENABLE_C
6c30: 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 29 0a  OLUMN_METADATA).
6c40: 23 20 65 72 72 6f 72 20 22 4d 75 73 74 20 6e 6f  # error "Must no
6c50: 74 20 64 65 66 69 6e 65 20 62 6f 74 68 20 53 51  t define both SQ
6c60: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 59  LITE_OMIT_DECLTY
6c70: 50 45 20 5c 0a 20 20 20 20 20 20 20 20 20 61 6e  PE \.         an
6c80: 64 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  d SQLITE_ENABLE_
6c90: 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 22  COLUMN_METADATA"
6ca0: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66  .#endif..#ifndef
6cb0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43   SQLITE_OMIT_DEC
6cc0: 4c 54 59 50 45 0a 2f 2a 0a 2a 2a 20 52 65 74 75  LTYPE./*.** Retu
6cd0: 72 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65  rn the column de
6ce0: 63 6c 61 72 61 74 69 6f 6e 20 74 79 70 65 20 28  claration type (
6cf0: 69 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 6f  if applicable) o
6d00: 66 20 74 68 65 20 27 69 27 74 68 20 63 6f 6c 75  f the 'i'th colu
6d10: 6d 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73  mn.** of the res
6d20: 75 6c 74 20 73 65 74 20 6f 66 20 53 51 4c 20 73  ult set of SQL s
6d30: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a  tatement pStmt..
6d40: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
6d50: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65  qlite3_column_de
6d60: 63 6c 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73  cltype(sqlite3_s
6d70: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
6d80: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
6d90: 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70  umnName(.      p
6da0: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20  Stmt, N, (const 
6db0: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73  void*(*)(Mem*))s
6dc0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
6dd0: 74 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 43 4c 54  t, COLNAME_DECLT
6de0: 59 50 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20  YPE);.}.#ifndef 
6df0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
6e00: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  6.const void *sq
6e10: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63  lite3_column_dec
6e20: 6c 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f  ltype16(sqlite3_
6e30: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
6e40: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   N){.  return co
6e50: 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20  lumnName(.      
6e60: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74  pStmt, N, (const
6e70: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29   void*(*)(Mem*))
6e80: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
6e90: 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45  xt16, COLNAME_DE
6ea0: 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 65 6e 64 69  CLTYPE);.}.#endi
6eb0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
6ec0: 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69 66  _UTF16 */.#endif
6ed0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
6ee0: 44 45 43 4c 54 59 50 45 20 2a 2f 0a 0a 23 69 66  DECLTYPE */..#if
6ef0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
6f00: 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54  E_COLUMN_METADAT
6f10: 41 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  A./*.** Return t
6f20: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64  he name of the d
6f30: 61 74 61 62 61 73 65 20 66 72 6f 6d 20 77 68 69  atabase from whi
6f40: 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75  ch a result colu
6f50: 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e  mn derives..** N
6f60: 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20  ULL is returned 
6f70: 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f  if the result co
6f80: 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65  lumn is an expre
6f90: 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e  ssion or constan
6fa0: 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67  t or.** anything
6fb0: 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e   else which is n
6fc0: 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73  ot an unabiguous
6fd0: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20   reference to a 
6fe0: 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e  database column.
6ff0: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
7000: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
7010: 61 74 61 62 61 73 65 5f 6e 61 6d 65 28 73 71 6c  atabase_name(sql
7020: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
7030: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
7040: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20  rn columnName(. 
7050: 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28       pStmt, N, (
7060: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d  const void*(*)(M
7070: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c  em*))sqlite3_val
7080: 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45  ue_text, COLNAME
7090: 5f 44 41 54 41 42 41 53 45 29 3b 0a 7d 0a 23 69  _DATABASE);.}.#i
70a0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
70b0: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f  T_UTF16.const vo
70c0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
70d0: 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65  mn_database_name
70e0: 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  16(sqlite3_stmt 
70f0: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a  *pStmt, int N){.
7100: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e    return columnN
7110: 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74  ame(.      pStmt
7120: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64  , N, (const void
7130: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74  *(*)(Mem*))sqlit
7140: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c  e3_value_text16,
7150: 20 43 4f 4c 4e 41 4d 45 5f 44 41 54 41 42 41 53   COLNAME_DATABAS
7160: 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  E);.}.#endif /* 
7170: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
7180: 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  6 */../*.** Retu
7190: 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  rn the name of t
71a0: 68 65 20 74 61 62 6c 65 20 66 72 6f 6d 20 77 68  he table from wh
71b0: 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c  ich a result col
71c0: 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20  umn derives..** 
71d0: 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64  NULL is returned
71e0: 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63   if the result c
71f0: 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72  olumn is an expr
7200: 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61  ession or consta
7210: 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e  nt or.** anythin
7220: 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20  g else which is 
7230: 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75  not an unabiguou
7240: 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61  s reference to a
7250: 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e   database column
7260: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20  ..*/.const char 
7270: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  *sqlite3_column_
7280: 74 61 62 6c 65 5f 6e 61 6d 65 28 73 71 6c 69 74  table_name(sqlit
7290: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
72a0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
72b0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20   columnName(.   
72c0: 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f     pStmt, N, (co
72d0: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
72e0: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
72f0: 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 54  _text, COLNAME_T
7300: 41 42 4c 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  ABLE);.}.#ifndef
7310: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
7320: 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73  16.const void *s
7330: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61  qlite3_column_ta
7340: 62 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74  ble_name16(sqlit
7350: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
7360: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
7370: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20   columnName(.   
7380: 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f     pStmt, N, (co
7390: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d  nst void*(*)(Mem
73a0: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  *))sqlite3_value
73b0: 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45  _text16, COLNAME
73c0: 5f 54 41 42 4c 45 29 3b 0a 7d 0a 23 65 6e 64 69  _TABLE);.}.#endi
73d0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
73e0: 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a  _UTF16 */../*.**
73f0: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65   Return the name
7400: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 63 6f   of the table co
7410: 6c 75 6d 6e 20 66 72 6f 6d 20 77 68 69 63 68 20  lumn from which 
7420: 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20  a result column 
7430: 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c  derives..** NULL
7440: 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20   is returned if 
7450: 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d  the result colum
7460: 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 73 69  n is an expressi
7470: 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f  on or constant o
7480: 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c  r.** anything el
7490: 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20  se which is not 
74a0: 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20 72 65  an unabiguous re
74b0: 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64 61 74  ference to a dat
74c0: 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f  abase column..*/
74d0: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c  .const char *sql
74e0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67  ite3_column_orig
74f0: 69 6e 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f  in_name(sqlite3_
7500: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
7510: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   N){.  return co
7520: 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20  lumnName(.      
7530: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74  pStmt, N, (const
7540: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29   void*(*)(Mem*))
7550: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
7560: 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 43 4f 4c 55  xt, COLNAME_COLU
7570: 4d 4e 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53  MN);.}.#ifndef S
7580: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
7590: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
75a0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67  ite3_column_orig
75b0: 69 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65  in_name16(sqlite
75c0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
75d0: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20  nt N){.  return 
75e0: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20  columnName(.    
75f0: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e    pStmt, N, (con
7600: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a  st void*(*)(Mem*
7610: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  ))sqlite3_value_
7620: 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f  text16, COLNAME_
7630: 43 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23 65 6e 64 69  COLUMN);.}.#endi
7640: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
7650: 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69 66  _UTF16 */.#endif
7660: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c   /* SQLITE_ENABL
7670: 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54  E_COLUMN_METADAT
7680: 41 20 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a  A */.../********
7690: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
76a0: 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f  ******* sqlite3_
76b0: 62 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  bind_  *********
76c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
76d0: 2a 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74 69 6e  **.** .** Routin
76e0: 65 73 20 75 73 65 64 20 74 6f 20 61 74 74 61 63  es used to attac
76f0: 68 20 76 61 6c 75 65 73 20 74 6f 20 77 69 6c 64  h values to wild
7700: 63 61 72 64 73 20 69 6e 20 61 20 63 6f 6d 70 69  cards in a compi
7710: 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  led SQL statemen
7720: 74 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e 62 69  t..*/./*.** Unbi
7730: 6e 64 20 74 68 65 20 76 61 6c 75 65 20 62 6f 75  nd the value bou
7740: 6e 64 20 74 6f 20 76 61 72 69 61 62 6c 65 20 69  nd to variable i
7750: 20 69 6e 20 76 69 72 74 75 61 6c 20 6d 61 63 68   in virtual mach
7760: 69 6e 65 20 70 2e 20 54 68 69 73 20 69 73 20 74  ine p. This is t
7770: 68 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20  he .** the same 
7780: 61 73 20 62 69 6e 64 69 6e 67 20 61 20 4e 55 4c  as binding a NUL
7790: 4c 20 76 61 6c 75 65 20 74 6f 20 74 68 65 20 63  L value to the c
77a0: 6f 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20 22 69  olumn. If the "i
77b0: 22 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a 2a  " parameter is.*
77c0: 2a 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20  * out of range, 
77d0: 74 68 65 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47  then SQLITE_RANG
77e0: 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f  E is returned. O
77f0: 74 68 65 77 69 73 65 20 53 51 4c 49 54 45 5f 4f  thewise SQLITE_O
7800: 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 72 72  K..**.** The err
7810: 6f 72 20 63 6f 64 65 20 73 74 6f 72 65 64 20 69  or code stored i
7820: 6e 20 64 61 74 61 62 61 73 65 20 70 2d 3e 64 62  n database p->db
7830: 20 69 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20   is overwritten 
7840: 77 69 74 68 20 74 68 65 20 72 65 74 75 72 6e 0a  with the return.
7850: 2a 2a 20 76 61 6c 75 65 20 69 6e 20 61 6e 79 20  ** value in any 
7860: 63 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  case..*/.static 
7870: 69 6e 74 20 76 64 62 65 55 6e 62 69 6e 64 28 56  int vdbeUnbind(V
7880: 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 29 7b 0a  dbe *p, int i){.
7890: 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 69    Mem *pVar;.  i
78a0: 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6d 61  f( p==0 || p->ma
78b0: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
78c0: 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30 20  RUN || p->pc>=0 
78d0: 29 7b 0a 20 20 20 20 69 66 28 20 70 20 29 20 73  ){.    if( p ) s
78e0: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
78f0: 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  b, SQLITE_MISUSE
7900: 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  , 0);.    return
7910: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
7920: 20 20 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c 7c    }.  if( i<1 ||
7930: 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20   i>p->nVar ){.  
7940: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70    sqlite3Error(p
7950: 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e  ->db, SQLITE_RAN
7960: 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75  GE, 0);.    retu
7970: 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 3b  rn SQLITE_RANGE;
7980: 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20 70 56  .  }.  i--;.  pV
7990: 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 5d  ar = &p->aVar[i]
79a0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
79b0: 65 6d 52 65 6c 65 61 73 65 28 70 56 61 72 29 3b  emRelease(pVar);
79c0: 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 73 20 3d  .  pVar->flags =
79d0: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 71 6c   MEM_Null;.  sql
79e0: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c  ite3Error(p->db,
79f0: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a   SQLITE_OK, 0);.
7a00: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
7a10: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e  OK;.}../*.** Bin
7a20: 64 20 61 20 74 65 78 74 20 6f 72 20 42 4c 4f 42  d a text or BLOB
7a30: 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69   value..*/.stati
7a40: 63 20 69 6e 74 20 62 69 6e 64 54 65 78 74 28 0a  c int bindText(.
7a50: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
7a60: 70 53 74 6d 74 2c 20 20 20 2f 2a 20 54 68 65 20  pStmt,   /* The 
7a70: 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 62 69 6e  statement to bin
7a80: 64 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69  d against */.  i
7a90: 6e 74 20 69 2c 20 20 20 20 20 20 20 20 20 20 20  nt i,           
7aa0: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f        /* Index o
7ab0: 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 72 20  f the parameter 
7ac0: 74 6f 20 62 69 6e 64 20 2a 2f 0a 20 20 63 6f 6e  to bind */.  con
7ad0: 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20  st void *zData, 
7ae0: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74      /* Pointer t
7af0: 6f 20 74 68 65 20 64 61 74 61 20 74 6f 20 62 65  o the data to be
7b00: 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 69 6e 74 20   bound */.  int 
7b10: 6e 44 61 74 61 2c 20 20 20 20 20 20 20 20 20 20  nData,          
7b20: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
7b30: 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 74 6f  bytes of data to
7b40: 20 62 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 76   be bound */.  v
7b50: 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64  oid (*xDel)(void
7b60: 2a 29 2c 20 20 20 2f 2a 20 44 65 73 74 72 75 63  *),   /* Destruc
7b70: 74 6f 72 20 66 6f 72 20 74 68 65 20 64 61 74 61  tor for the data
7b80: 20 2a 2f 0a 20 20 69 6e 74 20 65 6e 63 6f 64 69   */.  int encodi
7b90: 6e 67 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ng           /* 
7ba0: 45 6e 63 6f 64 69 6e 67 20 66 6f 72 20 74 68 65  Encoding for the
7bb0: 20 64 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 56 64   data */.){.  Vd
7bc0: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29  be *p = (Vdbe *)
7bd0: 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56  pStmt;.  Mem *pV
7be0: 61 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20  ar;.  int rc;.. 
7bf0: 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a 20 20 20   if( p==0 ){.   
7c00: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
7c10: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71 6c  ISUSE;.  }.  sql
7c20: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
7c30: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
7c40: 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e    rc = vdbeUnbin
7c50: 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72  d(p, i);.  if( r
7c60: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
7c70: 7a 44 61 74 61 21 3d 30 20 29 7b 0a 20 20 20 20  zData!=0 ){.    
7c80: 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b  pVar = &p->aVar[
7c90: 69 2d 31 5d 3b 0a 20 20 20 20 72 63 20 3d 20 73  i-1];.    rc = s
7ca0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
7cb0: 53 74 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c  Str(pVar, zData,
7cc0: 20 6e 44 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67   nData, encoding
7cd0: 2c 20 78 44 65 6c 29 3b 0a 20 20 20 20 69 66 28  , xDel);.    if(
7ce0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
7cf0: 26 20 65 6e 63 6f 64 69 6e 67 21 3d 30 20 29 7b  & encoding!=0 ){
7d00: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
7d10: 74 65 33 56 64 62 65 43 68 61 6e 67 65 45 6e 63  te3VdbeChangeEnc
7d20: 6f 64 69 6e 67 28 70 56 61 72 2c 20 45 4e 43 28  oding(pVar, ENC(
7d30: 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 7d 0a 20  p->db));.    }. 
7d40: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
7d50: 70 2d 3e 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20  p->db, rc, 0);. 
7d60: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41     rc = sqlite3A
7d70: 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 72 63  piExit(p->db, rc
7d80: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  );.  }.  sqlite3
7d90: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e  _mutex_leave(p->
7da0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65  db->mutex);.  re
7db0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a  turn rc;.}.../*.
7dc0: 2a 2a 20 42 69 6e 64 20 61 20 62 6c 6f 62 20 76  ** Bind a blob v
7dd0: 61 6c 75 65 20 74 6f 20 61 6e 20 53 51 4c 20 73  alue to an SQL s
7de0: 74 61 74 65 6d 65 6e 74 20 76 61 72 69 61 62 6c  tatement variabl
7df0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
7e00: 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a 20 20 73  3_bind_blob(.  s
7e10: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
7e20: 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20  mt, .  int i, . 
7e30: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61   const void *zDa
7e40: 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61  ta, .  int nData
7e50: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  , .  void (*xDel
7e60: 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65  )(void*).){.  re
7e70: 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53  turn bindText(pS
7e80: 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e  tmt, i, zData, n
7e90: 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b 0a  Data, xDel, 0);.
7ea0: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69  }.int sqlite3_bi
7eb0: 6e 64 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65  nd_double(sqlite
7ec0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
7ed0: 6e 74 20 69 2c 20 64 6f 75 62 6c 65 20 72 56 61  nt i, double rVa
7ee0: 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  lue){.  int rc;.
7ef0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
7f00: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 73 71 6c  e *)pStmt;.  sql
7f10: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
7f20: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
7f30: 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e    rc = vdbeUnbin
7f40: 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72  d(p, i);.  if( r
7f50: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
7f60: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
7f70: 65 6d 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e  emSetDouble(&p->
7f80: 61 56 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75  aVar[i-1], rValu
7f90: 65 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  e);.  }.  sqlite
7fa0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d  3_mutex_leave(p-
7fb0: 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72  >db->mutex);.  r
7fc0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
7fd0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74  sqlite3_bind_int
7fe0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
7ff0: 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 56 61  , int i, int iVa
8000: 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 73  lue){.  return s
8010: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36  qlite3_bind_int6
8020: 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69 56 61  4(p, i, (i64)iVa
8030: 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  lue);.}.int sqli
8040: 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 73  te3_bind_int64(s
8050: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
8060: 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69 74  mt, int i, sqlit
8070: 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 29 7b  e_int64 iValue){
8080: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62  .  int rc;.  Vdb
8090: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
80a0: 53 74 6d 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f  Stmt;.  sqlite3_
80b0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64  mutex_enter(p->d
80c0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 63 20  b->mutex);.  rc 
80d0: 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20  = vdbeUnbind(p, 
80e0: 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  i);.  if( rc==SQ
80f0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73  LITE_OK ){.    s
8100: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
8110: 49 6e 74 36 34 28 26 70 2d 3e 61 56 61 72 5b 69  Int64(&p->aVar[i
8120: 2d 31 5d 2c 20 69 56 61 6c 75 65 29 3b 0a 20 20  -1], iValue);.  
8130: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  }.  sqlite3_mute
8140: 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d  x_leave(p->db->m
8150: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
8160: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  rc;.}.int sqlite
8170: 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69  3_bind_null(sqli
8180: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
8190: 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 72   int i){.  int r
81a0: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  c;.  Vdbe *p = (
81b0: 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 73  Vdbe*)pStmt;.  s
81c0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
81d0: 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  er(p->db->mutex)
81e0: 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62  ;.  rc = vdbeUnb
81f0: 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 73 71 6c  ind(p, i);.  sql
8200: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
8210: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
8220: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69    return rc;.}.i
8230: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
8240: 74 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65 33  text( .  sqlite3
8250: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20  _stmt *pStmt, . 
8260: 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74   int i, .  const
8270: 20 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a 20   char *zData, . 
8280: 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76   int nData, .  v
8290: 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64  oid (*xDel)(void
82a0: 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62  *).){.  return b
82b0: 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69  indText(pStmt, i
82c0: 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20  , zData, nData, 
82d0: 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46  xDel, SQLITE_UTF
82e0: 38 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  8);.}.#ifndef SQ
82f0: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
8300: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
8310: 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 74  _text16(.  sqlit
8320: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
8330: 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e  .  int i, .  con
8340: 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20  st void *zData, 
8350: 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20  .  int nData, . 
8360: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f   void (*xDel)(vo
8370: 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e  id*).){.  return
8380: 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c   bindText(pStmt,
8390: 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61   i, zData, nData
83a0: 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55  , xDel, SQLITE_U
83b0: 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 23  TF16NATIVE);.}.#
83c0: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
83d0: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e  OMIT_UTF16 */.in
83e0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 76  t sqlite3_bind_v
83f0: 61 6c 75 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  alue(sqlite3_stm
8400: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c  t *pStmt, int i,
8410: 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 76   const sqlite3_v
8420: 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b 0a 20  alue *pValue){. 
8430: 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20   int rc;.  Vdbe 
8440: 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74  *p = (Vdbe *)pSt
8450: 6d 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75  mt;.  sqlite3_mu
8460: 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d  tex_enter(p->db-
8470: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 63 20 3d 20  >mutex);.  rc = 
8480: 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29  vdbeUnbind(p, i)
8490: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ;.  if( rc==SQLI
84a0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20  TE_OK ){.    rc 
84b0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d  = sqlite3VdbeMem
84c0: 43 6f 70 79 28 26 70 2d 3e 61 56 61 72 5b 69 2d  Copy(&p->aVar[i-
84d0: 31 5d 2c 20 70 56 61 6c 75 65 29 3b 0a 20 20 7d  1], pValue);.  }
84e0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41  .  rc = sqlite3A
84f0: 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 72 63  piExit(p->db, rc
8500: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  );.  sqlite3_mut
8510: 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e  ex_leave(p->db->
8520: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e  mutex);.  return
8530: 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74   rc;.}.int sqlit
8540: 65 33 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62  e3_bind_zeroblob
8550: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
8560: 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 69 6e 74  Stmt, int i, int
8570: 20 6e 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20   n){.  int rc;. 
8580: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
8590: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 73 71 6c 69   *)pStmt;.  sqli
85a0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
85b0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
85c0: 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64   rc = vdbeUnbind
85d0: 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63  (p, i);.  if( rc
85e0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
85f0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65     sqlite3VdbeMe
8600: 6d 53 65 74 5a 65 72 6f 42 6c 6f 62 28 26 70 2d  mSetZeroBlob(&p-
8610: 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 6e 29 3b 0a  >aVar[i-1], n);.
8620: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75    }.  sqlite3_mu
8630: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d  tex_leave(p->db-
8640: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72  >mutex);.  retur
8650: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
8660: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
8670: 20 6f 66 20 77 69 6c 64 63 61 72 64 73 20 74 68   of wildcards th
8680: 61 74 20 63 61 6e 20 62 65 20 70 6f 74 65 6e 74  at can be potent
8690: 69 61 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e 0a  ially bound to..
86a0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
86b0: 69 73 20 61 64 64 65 64 20 74 6f 20 73 75 70 70  is added to supp
86c0: 6f 72 74 20 44 42 44 3a 3a 53 51 4c 69 74 65 2e  ort DBD::SQLite.
86d0: 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65    .*/.int sqlite
86e0: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72  3_bind_parameter
86f0: 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73  _count(sqlite3_s
8700: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56  tmt *pStmt){.  V
8710: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29  dbe *p = (Vdbe*)
8720: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20  pStmt;.  return 
8730: 70 20 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30 3b  p ? p->nVar : 0;
8740: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65  .}../*.** Create
8750: 20 61 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20   a mapping from 
8760: 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 73  variable numbers
8770: 20 74 6f 20 76 61 72 69 61 62 6c 65 20 6e 61 6d   to variable nam
8780: 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 64 62  es.** in the Vdb
8790: 65 2e 61 7a 56 61 72 5b 5d 20 61 72 72 61 79 2c  e.azVar[] array,
87a0: 20 69 66 20 73 75 63 68 20 61 20 6d 61 70 70 69   if such a mappi
87b0: 6e 67 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65  ng does not alre
87c0: 61 64 79 0a 2a 2a 20 65 78 69 73 74 2e 0a 2a 2f  ady.** exist..*/
87d0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 72 65  .static void cre
87e0: 61 74 65 56 61 72 4d 61 70 28 56 64 62 65 20 2a  ateVarMap(Vdbe *
87f0: 70 29 7b 0a 20 20 69 66 28 20 21 70 2d 3e 6f 6b  p){.  if( !p->ok
8800: 56 61 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Var ){.    sqlit
8810: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
8820: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  ->db->mutex);.  
8830: 20 20 69 66 28 20 21 70 2d 3e 6f 6b 56 61 72 20    if( !p->okVar 
8840: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6a 3b 0a  ){.      int j;.
8850: 20 20 20 20 20 20 4f 70 20 2a 70 4f 70 3b 0a 20        Op *pOp;. 
8860: 20 20 20 20 20 66 6f 72 28 6a 3d 30 2c 20 70 4f       for(j=0, pO
8870: 70 3d 70 2d 3e 61 4f 70 3b 20 6a 3c 70 2d 3e 6e  p=p->aOp; j<p->n
8880: 4f 70 3b 20 6a 2b 2b 2c 20 70 4f 70 2b 2b 29 7b  Op; j++, pOp++){
8890: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 4f 70  .        if( pOp
88a0: 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 56 61 72  ->opcode==OP_Var
88b0: 69 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 20  iable ){.       
88c0: 20 20 20 61 73 73 65 72 74 28 20 70 4f 70 2d 3e     assert( pOp->
88d0: 70 31 3e 30 20 26 26 20 70 4f 70 2d 3e 70 31 3c  p1>0 && pOp->p1<
88e0: 3d 70 2d 3e 6e 56 61 72 20 29 3b 0a 20 20 20 20  =p->nVar );.    
88f0: 20 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 5b 70        p->azVar[p
8900: 4f 70 2d 3e 70 31 2d 31 5d 20 3d 20 70 4f 70 2d  Op->p1-1] = pOp-
8910: 3e 70 34 2e 7a 3b 0a 20 20 20 20 20 20 20 20 7d  >p4.z;.        }
8920: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70  .      }.      p
8930: 2d 3e 6f 6b 56 61 72 20 3d 20 31 3b 0a 20 20 20  ->okVar = 1;.   
8940: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d   }.    sqlite3_m
8950: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62  utex_leave(p->db
8960: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a  ->mutex);.  }.}.
8970: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
8980: 65 20 6e 61 6d 65 20 6f 66 20 61 20 77 69 6c 64  e name of a wild
8990: 63 61 72 64 20 70 61 72 61 6d 65 74 65 72 2e 20  card parameter. 
89a0: 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 20   Return NULL if 
89b0: 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 69 73 20  the index.** is 
89c0: 6f 75 74 20 6f 66 20 72 61 6e 67 65 20 6f 72 20  out of range or 
89d0: 69 66 20 74 68 65 20 77 69 6c 64 63 61 72 64 20  if the wildcard 
89e0: 69 73 20 75 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a  is unnamed..**.*
89f0: 2a 20 54 68 65 20 72 65 73 75 6c 74 20 69 73 20  * The result is 
8a00: 61 6c 77 61 79 73 20 55 54 46 2d 38 2e 0a 2a 2f  always UTF-8..*/
8a10: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c  .const char *sql
8a20: 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65  ite3_bind_parame
8a30: 74 65 72 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33  ter_name(sqlite3
8a40: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
8a50: 74 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 20  t i){.  Vdbe *p 
8a60: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a  = (Vdbe*)pStmt;.
8a70: 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 69 3c    if( p==0 || i<
8a80: 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29  1 || i>p->nVar )
8a90: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  {.    return 0;.
8aa0: 20 20 7d 0a 20 20 63 72 65 61 74 65 56 61 72 4d    }.  createVarM
8ab0: 61 70 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20  ap(p);.  return 
8ac0: 70 2d 3e 61 7a 56 61 72 5b 69 2d 31 5d 3b 0a 7d  p->azVar[i-1];.}
8ad0: 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20  ../*.** Given a 
8ae0: 77 69 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74  wildcard paramet
8af0: 65 72 20 6e 61 6d 65 2c 20 72 65 74 75 72 6e 20  er name, return 
8b00: 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65  the index of the
8b10: 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 77 69 74   variable.** wit
8b20: 68 20 74 68 61 74 20 6e 61 6d 65 2e 20 20 49 66  h that name.  If
8b30: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 76 61 72   there is no var
8b40: 69 61 62 6c 65 20 77 69 74 68 20 74 68 65 20 67  iable with the g
8b50: 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a 20 72 65  iven name,.** re
8b60: 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73  turn 0..*/.int s
8b70: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 61  qlite3_bind_para
8b80: 6d 65 74 65 72 5f 69 6e 64 65 78 28 73 71 6c 69  meter_index(sqli
8b90: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
8ba0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
8bb0: 6d 65 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d  me){.  Vdbe *p =
8bc0: 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20   (Vdbe*)pStmt;. 
8bd0: 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 3d   int i;.  if( p=
8be0: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
8bf0: 20 30 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65   0;.  }.  create
8c00: 56 61 72 4d 61 70 28 70 29 3b 20 0a 20 20 69 66  VarMap(p); .  if
8c10: 28 20 7a 4e 61 6d 65 20 29 7b 0a 20 20 20 20 66  ( zName ){.    f
8c20: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 56 61  or(i=0; i<p->nVa
8c30: 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 63  r; i++){.      c
8c40: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 70  onst char *z = p
8c50: 2d 3e 61 7a 56 61 72 5b 69 5d 3b 0a 20 20 20 20  ->azVar[i];.    
8c60: 20 20 69 66 28 20 7a 20 26 26 20 73 74 72 63 6d    if( z && strcm
8c70: 70 28 7a 2c 7a 4e 61 6d 65 29 3d 3d 30 20 29 7b  p(z,zName)==0 ){
8c80: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
8c90: 69 2b 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  i+1;.      }.   
8ca0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
8cb0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 61 6e  0;.}../*.** Tran
8cc0: 73 66 65 72 20 61 6c 6c 20 62 69 6e 64 69 6e 67  sfer all binding
8cd0: 73 20 66 72 6f 6d 20 74 68 65 20 66 69 72 73 74  s from the first
8ce0: 20 73 74 61 74 65 6d 65 6e 74 20 6f 76 65 72 20   statement over 
8cf0: 74 6f 20 74 68 65 20 73 65 63 6f 6e 64 2e 0a 2a  to the second..*
8d00: 2a 20 49 66 20 74 68 65 20 74 77 6f 20 73 74 61  * If the two sta
8d10: 74 65 6d 65 6e 74 73 20 63 6f 6e 74 61 69 6e 20  tements contain 
8d20: 61 20 64 69 66 66 65 72 65 6e 74 20 6e 75 6d 62  a different numb
8d30: 65 72 20 6f 66 20 62 69 6e 64 69 6e 67 73 2c 20  er of bindings, 
8d40: 74 68 65 6e 0a 2a 2a 20 61 6e 20 53 51 4c 49 54  then.** an SQLIT
8d50: 45 5f 45 52 52 4f 52 20 69 73 20 72 65 74 75 72  E_ERROR is retur
8d60: 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ned..*/.int sqli
8d70: 74 65 33 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e  te3_transfer_bin
8d80: 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 74  dings(sqlite3_st
8d90: 6d 74 20 2a 70 46 72 6f 6d 53 74 6d 74 2c 20 73  mt *pFromStmt, s
8da0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 54 6f  qlite3_stmt *pTo
8db0: 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70  Stmt){.  Vdbe *p
8dc0: 46 72 6f 6d 20 3d 20 28 56 64 62 65 2a 29 70 46  From = (Vdbe*)pF
8dd0: 72 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 62 65 20  romStmt;.  Vdbe 
8de0: 2a 70 54 6f 20 3d 20 28 56 64 62 65 2a 29 70 54  *pTo = (Vdbe*)pT
8df0: 6f 53 74 6d 74 3b 0a 20 20 69 6e 74 20 69 2c 20  oStmt;.  int i, 
8e00: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
8e10: 20 20 69 66 28 20 28 70 46 72 6f 6d 2d 3e 6d 61    if( (pFrom->ma
8e20: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
8e30: 52 55 4e 20 26 26 20 70 46 72 6f 6d 2d 3e 6d 61  RUN && pFrom->ma
8e40: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
8e50: 48 41 4c 54 29 0a 20 20 20 20 7c 7c 20 28 70 54  HALT).    || (pT
8e60: 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  o->magic!=VDBE_M
8e70: 41 47 49 43 5f 52 55 4e 20 26 26 20 70 54 6f 2d  AGIC_RUN && pTo-
8e80: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
8e90: 49 43 5f 48 41 4c 54 29 0a 20 20 20 20 7c 7c 20  IC_HALT).    || 
8ea0: 70 54 6f 2d 3e 64 62 21 3d 70 46 72 6f 6d 2d 3e  pTo->db!=pFrom->
8eb0: 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  db ){.    return
8ec0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
8ed0: 20 20 7d 0a 20 20 69 66 28 20 70 46 72 6f 6d 2d    }.  if( pFrom-
8ee0: 3e 6e 56 61 72 21 3d 70 54 6f 2d 3e 6e 56 61 72  >nVar!=pTo->nVar
8ef0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
8f00: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
8f10: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
8f20: 5f 65 6e 74 65 72 28 70 54 6f 2d 3e 64 62 2d 3e  _enter(pTo->db->
8f30: 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 69 3d  mutex);.  for(i=
8f40: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  0; rc==SQLITE_OK
8f50: 20 26 26 20 69 3c 70 46 72 6f 6d 2d 3e 6e 56 61   && i<pFrom->nVa
8f60: 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c  r; i++){.    sql
8f70: 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f 76 65 28  ite3VdbeMemMove(
8f80: 26 70 54 6f 2d 3e 61 56 61 72 5b 69 5d 2c 20 26  &pTo->aVar[i], &
8f90: 70 46 72 6f 6d 2d 3e 61 56 61 72 5b 69 5d 29 3b  pFrom->aVar[i]);
8fa0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d  .  }.  sqlite3_m
8fb0: 75 74 65 78 5f 6c 65 61 76 65 28 70 54 6f 2d 3e  utex_leave(pTo->
8fc0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73  db->mutex);.  as
8fd0: 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45  sert( rc==SQLITE
8fe0: 5f 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54  _OK || rc==SQLIT
8ff0: 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 72 65 74  E_NOMEM );.  ret
9000: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
9010: 20 52 65 74 75 72 6e 20 74 68 65 20 73 71 6c 69   Return the sqli
9020: 74 65 33 2a 20 64 61 74 61 62 61 73 65 20 68 61  te3* database ha
9030: 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74 68  ndle to which th
9040: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  e prepared state
9050: 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 69 6e  ment given.** in
9060: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 62 65   the argument be
9070: 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 73 20  longs.  This is 
9080: 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73  the same databas
9090: 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 77 61  e handle that wa
90a0: 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 61  s.** the first a
90b0: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 73  rgument to the s
90c0: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29  qlite3_prepare()
90d0: 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20 74   that was used t
90e0: 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 65 20  o create.** the 
90f0: 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68 65  statement in the
9100: 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 2a 2f   first place..*/
9110: 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74 65  .sqlite3 *sqlite
9120: 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c 69  3_db_handle(sqli
9130: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29  te3_stmt *pStmt)
9140: 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d 74  {.  return pStmt
9150: 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d 74   ? ((Vdbe*)pStmt
9160: 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a           )->db : 0;.}.