0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32 /*.** 2004 May 2
0010: 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 6.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 ource code. In
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 **.** May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 evil..** May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 thers..** May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 y, never taking
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 .**.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75 contains code u
0190: 73 65 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 se to implement
01a0: 41 50 49 73 20 74 68 61 74 20 61 72 65 20 70 61 APIs that are pa
01b0: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 56 44 42 rt of the.** VDB
01c0: 45 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 76 64 E..**.** $Id: vd
01d0: 62 65 61 70 69 2e 63 2c 76 20 31 2e 31 35 33 20 beapi.c,v 1.153
01e0: 32 30 30 39 2f 30 33 2f 30 35 20 30 34 3a 32 33 2009/03/05 04:23
01f0: 3a 34 37 20 73 68 61 6e 65 20 45 78 70 20 24 0a :47 shane Exp $.
0200: 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c */.#include "sql
0210: 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 iteInt.h".#inclu
0220: 64 65 20 22 76 64 62 65 49 6e 74 2e 68 22 0a 0a de "vdbeInt.h"..
0230: 23 69 66 20 30 20 26 26 20 64 65 66 69 6e 65 64 #if 0 && defined
0240: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d (SQLITE_ENABLE_M
0250: 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 EMORY_MANAGEMENT
0260: 29 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c )./*.** The foll
0270: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
0280: 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72 contains pointer
0290: 73 20 74 6f 20 74 68 65 20 65 6e 64 20 70 6f 69 s to the end poi
02a0: 6e 74 73 20 6f 66 20 61 0a 2a 2a 20 64 6f 75 62 nts of a.** doub
02b0: 6c 79 2d 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f ly-linked list o
02c0: 66 20 61 6c 6c 20 63 6f 6d 70 69 6c 65 64 20 53 f all compiled S
02d0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 QL statements th
02e0: 61 74 20 6d 61 79 20 62 65 20 68 6f 6c 64 69 6e at may be holdin
02f0: 67 0a 2a 2a 20 62 75 66 66 65 72 73 20 65 6c 69 g.** buffers eli
0300: 67 69 62 6c 65 20 66 6f 72 20 72 65 6c 65 61 73 gible for releas
0310: 65 20 77 68 65 6e 20 74 68 65 20 73 71 6c 69 74 e when the sqlit
0320: 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 e3_release_memor
0330: 79 28 29 20 69 6e 74 65 72 66 61 63 65 20 69 73 y() interface is
0340: 0a 2a 2a 20 69 6e 76 6f 6b 65 64 2e 20 41 63 63 .** invoked. Acc
0350: 65 73 73 20 74 6f 20 74 68 69 73 20 6c 69 73 74 ess to this list
0360: 20 69 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 is protected by
0370: 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 the SQLITE_MUTE
0380: 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 0a 2a 2a X_STATIC_LRU2.**
0390: 20 6d 75 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 53 74 mutex..**.** St
03a0: 61 74 65 6d 65 6e 74 73 20 61 72 65 20 61 64 64 atements are add
03b0: 65 64 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 ed to the end of
03c0: 20 74 68 69 73 20 6c 69 73 74 20 77 68 65 6e 20 this list when
03d0: 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 29 20 sqlite3_reset()
03e0: 69 73 0a 2a 2a 20 63 61 6c 6c 65 64 2e 20 54 68 is.** called. Th
03f0: 65 79 20 61 72 65 20 72 65 6d 6f 76 65 64 20 65 ey are removed e
0400: 69 74 68 65 72 20 77 68 65 6e 20 73 71 6c 69 74 ither when sqlit
0410: 65 33 5f 73 74 65 70 28 29 20 6f 72 20 73 71 6c e3_step() or sql
0420: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 29 0a ite3_finalize().
0430: 2a 2a 20 69 73 20 63 61 6c 6c 65 64 2e 20 57 68 ** is called. Wh
0440: 65 6e 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 en statements ar
0450: 65 20 61 64 64 65 64 20 74 6f 20 74 68 69 73 20 e added to this
0460: 6c 69 73 74 2c 20 74 68 65 20 61 73 73 6f 63 69 list, the associ
0470: 61 74 65 64 20 0a 2a 2a 20 72 65 67 69 73 74 65 ated .** registe
0480: 72 20 61 72 72 61 79 20 28 70 2d 3e 61 4d 65 6d r array (p->aMem
0490: 5b 31 2e 2e 70 2d 3e 6e 4d 65 6d 5d 29 20 6d 61 [1..p->nMem]) ma
04a0: 79 20 63 6f 6e 74 61 69 6e 20 64 79 6e 61 6d 69 y contain dynami
04b0: 63 20 62 75 66 66 65 72 73 20 74 68 61 74 0a 2a c buffers that.*
04c0: 2a 20 63 61 6e 20 62 65 20 66 72 65 65 64 20 75 * can be freed u
04d0: 73 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62 65 sing sqlite3Vdbe
04e0: 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 29 2e ReleaseMemory().
04f0: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 73 74 61 74 .**.** When stat
0500: 65 6d 65 6e 74 73 20 61 72 65 20 61 64 64 65 64 ements are added
0510: 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d or removed from
0520: 20 74 68 69 73 20 6c 69 73 74 2c 20 74 68 65 20 this list, the
0530: 6d 75 74 65 78 0a 2a 2a 20 61 73 73 6f 63 69 61 mutex.** associa
0540: 74 65 64 20 77 69 74 68 20 74 68 65 20 56 64 62 ted with the Vdb
0550: 65 20 62 65 69 6e 67 20 61 64 64 65 64 20 6f 72 e being added or
0560: 20 72 65 6d 6f 76 65 64 20 28 56 64 62 65 2e 64 removed (Vdbe.d
0570: 62 2d 3e 6d 75 74 65 78 29 20 69 73 0a 2a 2a 20 b->mutex) is.**
0580: 61 6c 72 65 61 64 79 20 68 65 6c 64 2e 20 54 68 already held. Th
0590: 65 20 4c 52 55 32 20 6d 75 74 65 78 20 69 73 20 e LRU2 mutex is
05a0: 74 68 65 6e 20 6f 62 74 61 69 6e 65 64 2c 20 62 then obtained, b
05b0: 6c 6f 63 6b 69 6e 67 20 69 66 20 6e 65 63 65 73 locking if neces
05c0: 73 61 72 79 2c 0a 2a 2a 20 74 68 65 20 6c 69 6e sary,.** the lin
05d0: 6b 65 64 2d 6c 69 73 74 20 70 6f 69 6e 74 65 72 ked-list pointer
05e0: 73 20 6d 61 6e 69 70 75 6c 61 74 65 64 20 61 6e s manipulated an
05f0: 64 20 74 68 65 20 4c 52 55 32 20 6d 75 74 65 78 d the LRU2 mutex
0600: 20 72 65 6c 69 6e 71 75 69 73 68 65 64 2e 0a 2a relinquished..*
0610: 2f 0a 73 74 72 75 63 74 20 53 74 61 74 65 6d 65 /.struct Stateme
0620: 6e 74 4c 72 75 4c 69 73 74 20 7b 0a 20 20 56 64 ntLruList {. Vd
0630: 62 65 20 2a 70 46 69 72 73 74 3b 0a 20 20 56 64 be *pFirst;. Vd
0640: 62 65 20 2a 70 4c 61 73 74 3b 0a 7d 3b 0a 73 74 be *pLast;.};.st
0650: 61 74 69 63 20 73 74 72 75 63 74 20 53 74 61 74 atic struct Stat
0660: 65 6d 65 6e 74 4c 72 75 4c 69 73 74 20 73 71 6c ementLruList sql
0670: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 ite3LruStatement
0680: 73 3b 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 s;../*.** Check
0690: 74 68 61 74 20 74 68 65 20 6c 69 73 74 20 6c 6f that the list lo
06a0: 6f 6b 73 20 74 6f 20 62 65 20 69 6e 74 65 72 6e oks to be intern
06b0: 61 6c 6c 79 20 63 6f 6e 73 69 73 74 65 6e 74 2e ally consistent.
06c0: 20 54 68 69 73 20 69 73 20 75 73 65 64 0a 2a 2a This is used.**
06d0: 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 61 as part of an a
06e0: 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
06f0: 74 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a t as follows:.**
0700: 0a 2a 2a 20 20 20 61 73 73 65 72 74 28 20 73 74 .** assert( st
0710: 6d 74 4c 72 75 43 68 65 63 6b 28 29 20 29 3b 0a mtLruCheck() );.
0720: 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 */.#ifndef NDEBU
0730: 47 0a 73 74 61 74 69 63 20 69 6e 74 20 73 74 6d G.static int stm
0740: 74 4c 72 75 43 68 65 63 6b 28 29 7b 0a 20 20 56 tLruCheck(){. V
0750: 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d dbe *p;. for(p=
0760: 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d sqlite3LruStatem
0770: 65 6e 74 73 2e 70 46 69 72 73 74 3b 20 70 3b 20 ents.pFirst; p;
0780: 70 3d 70 2d 3e 70 4c 72 75 4e 65 78 74 29 7b 0a p=p->pLruNext){.
0790: 20 20 20 20 61 73 73 65 72 74 28 70 2d 3e 70 4c assert(p->pL
07a0: 72 75 4e 65 78 74 20 7c 7c 20 70 3d 3d 73 71 6c ruNext || p==sql
07b0: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 ite3LruStatement
07c0: 73 2e 70 4c 61 73 74 29 3b 0a 20 20 20 20 61 73 s.pLast);. as
07d0: 73 65 72 74 28 21 70 2d 3e 70 4c 72 75 4e 65 78 sert(!p->pLruNex
07e0: 74 20 7c 7c 20 70 2d 3e 70 4c 72 75 4e 65 78 74 t || p->pLruNext
07f0: 2d 3e 70 4c 72 75 50 72 65 76 3d 3d 70 29 3b 0a ->pLruPrev==p);.
0800: 20 20 20 20 61 73 73 65 72 74 28 70 2d 3e 70 4c assert(p->pL
0810: 72 75 50 72 65 76 20 7c 7c 20 70 3d 3d 73 71 6c ruPrev || p==sql
0820: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 ite3LruStatement
0830: 73 2e 70 46 69 72 73 74 29 3b 0a 20 20 20 20 61 s.pFirst);. a
0840: 73 73 65 72 74 28 21 70 2d 3e 70 4c 72 75 50 72 ssert(!p->pLruPr
0850: 65 76 20 7c 7c 20 70 2d 3e 70 4c 72 75 50 72 65 ev || p->pLruPre
0860: 76 2d 3e 70 4c 72 75 4e 65 78 74 3d 3d 70 29 3b v->pLruNext==p);
0870: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 31 3b . }. return 1;
0880: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
0890: 20 41 64 64 20 76 64 62 65 20 70 20 74 6f 20 74 Add vdbe p to t
08a0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 73 74 he end of the st
08b0: 61 74 65 6d 65 6e 74 20 6c 72 75 20 6c 69 73 74 atement lru list
08c0: 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 . It is assumed
08d0: 74 68 61 74 0a 2a 2a 20 70 20 69 73 20 6e 6f 74 that.** p is not
08e0: 20 61 6c 72 65 61 64 79 20 70 61 72 74 20 6f 66 already part of
08f0: 20 74 68 65 20 6c 69 73 74 20 77 68 65 6e 20 74 the list when t
0900: 68 69 73 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 his is called. T
0910: 68 65 20 6c 72 75 20 6c 69 73 74 0a 2a 2a 20 69 he lru list.** i
0920: 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 74 s protected by t
0930: 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f he SQLITE_MUTEX_
0940: 53 54 41 54 49 43 5f 4c 52 55 20 6d 75 74 65 78 STATIC_LRU mutex
0950: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
0960: 20 73 74 6d 74 4c 72 75 41 64 64 28 56 64 62 65 stmtLruAdd(Vdbe
0970: 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f *p){. sqlite3_
0980: 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 mutex_enter(sqli
0990: 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
09a0: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
09b0: 43 5f 4c 52 55 32 29 29 3b 0a 0a 20 20 69 66 28 C_LRU2));.. if(
09c0: 20 70 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 p->pLruPrev ||
09d0: 70 2d 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 73 p->pLruNext || s
09e0: 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 qlite3LruStateme
09f0: 6e 74 73 2e 70 46 69 72 73 74 3d 3d 70 20 29 7b nts.pFirst==p ){
0a00: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 . sqlite3_mut
0a10: 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 ex_leave(sqlite3
0a20: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
0a30: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c E_MUTEX_STATIC_L
0a40: 52 55 32 29 29 3b 0a 20 20 20 20 72 65 74 75 72 RU2));. retur
0a50: 6e 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 n;. }.. assert
0a60: 28 20 73 74 6d 74 4c 72 75 43 68 65 63 6b 28 29 ( stmtLruCheck()
0a70: 20 29 3b 0a 0a 20 20 69 66 28 20 21 73 71 6c 69 );.. if( !sqli
0a80: 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 te3LruStatements
0a90: 2e 70 46 69 72 73 74 20 29 7b 0a 20 20 20 20 61 .pFirst ){. a
0aa0: 73 73 65 72 74 28 20 21 73 71 6c 69 74 65 33 4c ssert( !sqlite3L
0ab0: 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 ruStatements.pLa
0ac0: 73 74 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 st );. sqlite
0ad0: 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 73 2e 70 3LruStatements.p
0ae0: 46 69 72 73 74 20 3d 20 70 3b 0a 20 20 20 20 73 First = p;. s
0af0: 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 qlite3LruStateme
0b00: 6e 74 73 2e 70 4c 61 73 74 20 3d 20 70 3b 0a 20 nts.pLast = p;.
0b10: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
0b20: 72 74 28 20 21 73 71 6c 69 74 65 33 4c 72 75 53 rt( !sqlite3LruS
0b30: 74 61 74 65 6d 65 6e 74 73 2e 70 4c 61 73 74 2d tatements.pLast-
0b40: 3e 70 4c 72 75 4e 65 78 74 20 29 3b 0a 20 20 20 >pLruNext );.
0b50: 20 70 2d 3e 70 4c 72 75 50 72 65 76 20 3d 20 73 p->pLruPrev = s
0b60: 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 qlite3LruStateme
0b70: 6e 74 73 2e 70 4c 61 73 74 3b 0a 20 20 20 20 73 nts.pLast;. s
0b80: 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 qlite3LruStateme
0b90: 6e 74 73 2e 70 4c 61 73 74 2d 3e 70 4c 72 75 4e nts.pLast->pLruN
0ba0: 65 78 74 20 3d 20 70 3b 0a 20 20 20 20 73 71 6c ext = p;. sql
0bb0: 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 6e 74 ite3LruStatement
0bc0: 73 2e 70 4c 61 73 74 20 3d 20 70 3b 0a 20 20 7d s.pLast = p;. }
0bd0: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 .. assert( stmt
0be0: 4c 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 0a 20 LruCheck() );..
0bf0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
0c00: 65 61 76 65 28 73 71 6c 69 74 65 33 4d 75 74 65 eave(sqlite3Mute
0c10: 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
0c20: 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 29 TEX_STATIC_LRU2)
0c30: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 );.}../*.** Assu
0c40: 6d 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f ming the SQLITE_
0c50: 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 MUTEX_STATIC_LRU
0c60: 32 20 6d 75 74 65 78 74 20 69 73 20 61 6c 72 65 2 mutext is alre
0c70: 61 64 79 20 68 65 6c 64 2c 20 72 65 6d 6f 76 65 ady held, remove
0c80: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 70 20 .** statement p
0c90: 66 72 6f 6d 20 74 68 65 20 6c 65 61 73 74 2d 72 from the least-r
0ca0: 65 63 65 6e 74 6c 79 2d 75 73 65 64 20 73 74 61 ecently-used sta
0cb0: 74 65 6d 65 6e 74 20 6c 69 73 74 2e 20 49 66 20 tement list. If
0cc0: 74 68 65 20 0a 2a 2a 20 73 74 61 74 65 6d 65 6e the .** statemen
0cd0: 74 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 t is not current
0ce0: 6c 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 6c ly part of the l
0cf0: 69 73 74 2c 20 74 68 69 73 20 63 61 6c 6c 20 69 ist, this call i
0d00: 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 s a no-op..*/.st
0d10: 61 74 69 63 20 76 6f 69 64 20 73 74 6d 74 4c 72 atic void stmtLr
0d20: 75 52 65 6d 6f 76 65 4e 6f 6d 75 74 65 78 28 56 uRemoveNomutex(V
0d30: 64 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 dbe *p){. if( p
0d40: 2d 3e 70 4c 72 75 50 72 65 76 20 7c 7c 20 70 2d ->pLruPrev || p-
0d50: 3e 70 4c 72 75 4e 65 78 74 20 7c 7c 20 70 3d 3d >pLruNext || p==
0d60: 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d sqlite3LruStatem
0d70: 65 6e 74 73 2e 70 46 69 72 73 74 20 29 7b 0a 20 ents.pFirst ){.
0d80: 20 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c assert( stmtL
0d90: 72 75 43 68 65 63 6b 28 29 20 29 3b 0a 20 20 20 ruCheck() );.
0da0: 20 69 66 28 20 70 2d 3e 70 4c 72 75 4e 65 78 74 if( p->pLruNext
0db0: 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4c 72 ){. p->pLr
0dc0: 75 4e 65 78 74 2d 3e 70 4c 72 75 50 72 65 76 20 uNext->pLruPrev
0dd0: 3d 20 70 2d 3e 70 4c 72 75 50 72 65 76 3b 0a 20 = p->pLruPrev;.
0de0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
0df0: 73 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d sqlite3LruStatem
0e00: 65 6e 74 73 2e 70 4c 61 73 74 20 3d 20 70 2d 3e ents.pLast = p->
0e10: 70 4c 72 75 50 72 65 76 3b 0a 20 20 20 20 7d 0a pLruPrev;. }.
0e20: 20 20 20 20 69 66 28 20 70 2d 3e 70 4c 72 75 50 if( p->pLruP
0e30: 72 65 76 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e rev ){. p->
0e40: 70 4c 72 75 50 72 65 76 2d 3e 70 4c 72 75 4e 65 pLruPrev->pLruNe
0e50: 78 74 20 3d 20 70 2d 3e 70 4c 72 75 4e 65 78 74 xt = p->pLruNext
0e60: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
0e70: 20 20 20 73 71 6c 69 74 65 33 4c 72 75 53 74 61 sqlite3LruSta
0e80: 74 65 6d 65 6e 74 73 2e 70 46 69 72 73 74 20 3d tements.pFirst =
0e90: 20 70 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 20 20 p->pLruNext;.
0ea0: 20 20 7d 0a 20 20 20 20 70 2d 3e 70 4c 72 75 4e }. p->pLruN
0eb0: 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e ext = 0;. p->
0ec0: 70 4c 72 75 50 72 65 76 20 3d 20 30 3b 0a 20 20 pLruPrev = 0;.
0ed0: 20 20 61 73 73 65 72 74 28 20 73 74 6d 74 4c 72 assert( stmtLr
0ee0: 75 43 68 65 63 6b 28 29 20 29 3b 0a 20 20 7d 0a uCheck() );. }.
0ef0: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d 69 6e }../*.** Assumin
0f00: 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 g the SQLITE_MUT
0f10: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 32 20 6d EX_STATIC_LRU2 m
0f20: 75 74 65 78 74 20 69 73 20 6e 6f 74 20 68 65 6c utext is not hel
0f30: 64 2c 20 72 65 6d 6f 76 65 0a 2a 2a 20 73 74 61 d, remove.** sta
0f40: 74 65 6d 65 6e 74 20 70 20 66 72 6f 6d 20 74 68 tement p from th
0f50: 65 20 6c 65 61 73 74 2d 72 65 63 65 6e 74 6c 79 e least-recently
0f60: 2d 75 73 65 64 20 73 74 61 74 65 6d 65 6e 74 20 -used statement
0f70: 6c 69 73 74 2e 20 49 66 20 74 68 65 20 0a 2a 2a list. If the .**
0f80: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f statement is no
0f90: 74 20 63 75 72 72 65 6e 74 6c 79 20 70 61 72 74 t currently part
0fa0: 20 6f 66 20 74 68 65 20 6c 69 73 74 2c 20 74 68 of the list, th
0fb0: 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d is call is a no-
0fc0: 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f op..*/.static vo
0fd0: 69 64 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76 65 id stmtLruRemove
0fe0: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c (Vdbe *p){. sql
0ff0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
1000: 28 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c (sqlite3MutexAll
1010: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
1020: 53 54 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 20 STATIC_LRU2));.
1030: 20 73 74 6d 74 4c 72 75 52 65 6d 6f 76 65 4e 6f stmtLruRemoveNo
1040: 6d 75 74 65 78 28 70 29 3b 0a 20 20 73 71 6c 69 mutex(p);. sqli
1050: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
1060: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
1070: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
1080: 54 41 54 49 43 5f 4c 52 55 32 29 29 3b 0a 7d 0a TATIC_LRU2));.}.
1090: 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 72 65 ./*.** Try to re
10a0: 6c 65 61 73 65 20 6e 20 62 79 74 65 73 20 6f 66 lease n bytes of
10b0: 20 6d 65 6d 6f 72 79 20 62 79 20 66 72 65 65 69 memory by freei
10c0: 6e 67 20 62 75 66 66 65 72 73 20 61 73 73 6f 63 ng buffers assoc
10d0: 69 61 74 65 64 20 0a 2a 2a 20 77 69 74 68 20 74 iated .** with t
10e0: 68 65 20 6d 65 6d 6f 72 79 20 72 65 67 69 73 74 he memory regist
10f0: 65 72 73 20 6f 66 20 63 75 72 72 65 6e 74 6c 79 ers of currently
1100: 20 75 6e 75 73 65 64 20 76 64 62 65 73 2e 0a 2a unused vdbes..*
1110: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 /.int sqlite3Vdb
1120: 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 eReleaseMemory(i
1130: 6e 74 20 6e 29 7b 0a 20 20 56 64 62 65 20 2a 70 nt n){. Vdbe *p
1140: 3b 0a 20 20 56 64 62 65 20 2a 70 4e 65 78 74 3b ;. Vdbe *pNext;
1150: 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20 30 . int nFree = 0
1160: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 ;.. sqlite3_mut
1170: 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 ex_enter(sqlite3
1180: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
1190: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c E_MUTEX_STATIC_L
11a0: 52 55 32 29 29 3b 0a 20 20 66 6f 72 28 70 3d 73 RU2));. for(p=s
11b0: 71 6c 69 74 65 33 4c 72 75 53 74 61 74 65 6d 65 qlite3LruStateme
11c0: 6e 74 73 2e 70 46 69 72 73 74 3b 20 70 20 26 26 nts.pFirst; p &&
11d0: 20 6e 46 72 65 65 3c 6e 3b 20 70 3d 70 4e 65 78 nFree<n; p=pNex
11e0: 74 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 t){. pNext =
11f0: 70 2d 3e 70 4c 72 75 4e 65 78 74 3b 0a 0a 20 20 p->pLruNext;..
1200: 20 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 73 74 /* For each st
1210: 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 20 69 atement handle i
1220: 6e 20 74 68 65 20 6c 72 75 20 6c 69 73 74 2c 20 n the lru list,
1230: 61 74 74 65 6d 70 74 20 74 6f 20 6f 62 74 61 69 attempt to obtai
1240: 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 61 73 73 n the. ** ass
1250: 6f 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 ociated database
1260: 20 6d 75 74 65 78 2e 20 49 66 20 69 74 20 63 61 mutex. If it ca
1270: 6e 6e 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 nnot be obtained
1280: 2c 20 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20 2a , continue. *
1290: 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 74 * to the next st
12a0: 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 20 atement handle.
12b0: 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 It is not possib
12c0: 6c 65 20 74 6f 20 62 6c 6f 63 6b 20 6f 6e 0a 20 le to block on.
12d0: 20 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 ** the databa
12e0: 73 65 20 6d 75 74 65 78 20 2d 20 74 68 61 74 20 se mutex - that
12f0: 63 6f 75 6c 64 20 63 61 75 73 65 20 64 65 61 64 could cause dead
1300: 6c 6f 63 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 lock.. */.
1310: 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d if( SQLITE_OK==
1320: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74 72 sqlite3_mutex_tr
1330: 79 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 y(p->db->mutex)
1340: 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65 20 2b ){. nFree +
1350: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 6c = sqlite3VdbeRel
1360: 65 61 73 65 42 75 66 66 65 72 73 28 70 29 3b 0a easeBuffers(p);.
1370: 20 20 20 20 20 20 73 74 6d 74 4c 72 75 52 65 6d stmtLruRem
1380: 6f 76 65 4e 6f 6d 75 74 65 78 28 70 29 3b 0a 20 oveNomutex(p);.
1390: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
13a0: 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e ex_leave(p->db->
13b0: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 mutex);. }.
13c0: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
13d0: 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 4d x_leave(sqlite3M
13e0: 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 utexAlloc(SQLITE
13f0: 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c 52 _MUTEX_STATIC_LR
1400: 55 32 29 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 U2));.. return
1410: 6e 46 72 65 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 nFree;.}../*.**
1420: 43 61 6c 6c 20 73 71 6c 69 74 65 33 52 65 70 72 Call sqlite3Repr
1430: 65 70 61 72 65 28 29 20 6f 6e 20 74 68 65 20 73 epare() on the s
1440: 74 61 74 65 6d 65 6e 74 2e 20 52 65 6d 6f 76 65 tatement. Remove
1450: 20 69 74 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 it from the.**
1460: 6c 72 75 20 6c 69 73 74 20 62 65 66 6f 72 65 20 lru list before
1470: 64 6f 69 6e 67 20 73 6f 2c 20 61 73 20 52 65 70 doing so, as Rep
1480: 72 65 70 61 72 65 28 29 20 77 69 6c 6c 20 66 72 repare() will fr
1490: 65 65 20 61 6c 6c 20 74 68 65 0a 2a 2a 20 6d 65 ee all the.** me
14a0: 6d 6f 72 79 20 72 65 67 69 73 74 65 72 20 62 75 mory register bu
14b0: 66 66 65 72 73 20 61 6e 79 77 61 79 2e 0a 2a 2f ffers anyway..*/
14c0: 0a 69 6e 74 20 76 64 62 65 52 65 70 72 65 70 61 .int vdbeReprepa
14d0: 72 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 re(Vdbe *p){. s
14e0: 74 6d 74 4c 72 75 52 65 6d 6f 76 65 28 70 29 3b tmtLruRemove(p);
14f0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
1500: 33 52 65 70 72 65 70 61 72 65 28 70 29 3b 0a 7d 3Reprepare(p);.}
1510: 0a 0a 23 65 6c 73 65 20 20 20 20 20 20 20 2f 2a ..#else /*
1520: 20 21 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f !SQLITE_ENABLE_
1530: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e MEMORY_MANAGEMEN
1540: 54 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 73 T */. #define s
1550: 74 6d 74 4c 72 75 52 65 6d 6f 76 65 28 78 29 0a tmtLruRemove(x).
1560: 20 20 23 64 65 66 69 6e 65 20 73 74 6d 74 4c 72 #define stmtLr
1570: 75 41 64 64 28 78 29 0a 20 20 23 64 65 66 69 6e uAdd(x). #defin
1580: 65 20 76 64 62 65 52 65 70 72 65 70 61 72 65 28 e vdbeReprepare(
1590: 78 29 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 x) sqlite3Reprep
15a0: 61 72 65 28 78 29 0a 23 65 6e 64 69 66 0a 0a 0a are(x).#endif...
15b0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
15c0: 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f MIT_DEPRECATED./
15d0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 *.** Return TRUE
15e0: 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 6f 66 20 74 (non-zero) of t
15f0: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 73 75 70 he statement sup
1600: 70 6c 69 65 64 20 61 73 20 61 6e 20 61 72 67 75 plied as an argu
1610: 6d 65 6e 74 20 6e 65 65 64 73 0a 2a 2a 20 74 6f ment needs.** to
1620: 20 62 65 20 72 65 63 6f 6d 70 69 6c 65 64 2e 20 be recompiled.
1630: 20 41 20 73 74 61 74 65 6d 65 6e 74 20 6e 65 65 A statement nee
1640: 64 73 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 ds to be recompi
1650: 6c 65 64 20 77 68 65 6e 65 76 65 72 20 74 68 65 led whenever the
1660: 0a 2a 2a 20 65 78 65 63 75 74 69 6f 6e 20 65 6e .** execution en
1670: 76 69 72 6f 6e 6d 65 6e 74 20 63 68 61 6e 67 65 vironment change
1680: 73 20 69 6e 20 61 20 77 61 79 20 74 68 61 74 20 s in a way that
1690: 77 6f 75 6c 64 20 61 6c 74 65 72 20 74 68 65 20 would alter the
16a0: 70 72 6f 67 72 61 6d 0a 2a 2a 20 74 68 61 74 20 program.** that
16b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 sqlite3_prepare(
16c0: 29 20 67 65 6e 65 72 61 74 65 73 2e 20 20 46 6f ) generates. Fo
16d0: 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 6e 65 r example, if ne
16e0: 77 20 66 75 6e 63 74 69 6f 6e 73 20 6f 72 0a 2a w functions or.*
16f0: 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 * collating sequ
1700: 65 6e 63 65 73 20 61 72 65 20 72 65 67 69 73 74 ences are regist
1710: 65 72 65 64 20 6f 72 20 69 66 20 61 6e 20 61 75 ered or if an au
1720: 74 68 6f 72 69 7a 65 72 20 66 75 6e 63 74 69 6f thorizer functio
1730: 6e 20 69 73 0a 2a 2a 20 61 64 64 65 64 20 6f 72 n is.** added or
1740: 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 changed..*/.int
1750: 20 73 71 6c 69 74 65 33 5f 65 78 70 69 72 65 64 sqlite3_expired
1760: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
1770: 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 Stmt){. Vdbe *p
1780: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b = (Vdbe*)pStmt;
1790: 0a 20 20 72 65 74 75 72 6e 20 70 3d 3d 30 20 7c . return p==0 |
17a0: 7c 20 70 2d 3e 65 78 70 69 72 65 64 3b 0a 7d 0a | p->expired;.}.
17b0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
17c0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 e following rout
17d0: 69 6e 65 20 64 65 73 74 72 6f 79 73 20 61 20 76 ine destroys a v
17e0: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 irtual machine t
17f0: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 62 hat is created b
1800: 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74 65 33 y.** the sqlite3
1810: 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74 69 _compile() routi
1820: 6e 65 2e 20 54 68 65 20 69 6e 74 65 67 65 72 20 ne. The integer
1830: 72 65 74 75 72 6e 65 64 20 69 73 20 61 6e 20 53 returned is an S
1840: 51 4c 49 54 45 5f 0a 2a 2a 20 73 75 63 63 65 73 QLITE_.** succes
1850: 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 65 20 74 s/failure code t
1860: 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 hat describes th
1870: 65 20 72 65 73 75 6c 74 20 6f 66 20 65 78 65 63 e result of exec
1880: 75 74 69 6e 67 20 74 68 65 20 76 69 72 74 75 61 uting the virtua
1890: 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a l.** machine..**
18a0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
18b0: 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 sets the error
18c0: 63 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20 code and string
18d0: 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 returned by.** s
18e0: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 qlite3_errcode()
18f0: 2c 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 , sqlite3_errmsg
1900: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65 () and sqlite3_e
1910: 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e rrmsg16()..*/.in
1920: 74 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 t sqlite3_finali
1930: 7a 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 ze(sqlite3_stmt
1940: 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 *pStmt){. int r
1950: 63 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d c;. if( pStmt==
1960: 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 0 ){. rc = SQ
1970: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 LITE_OK;. }else
1980: 7b 0a 20 20 20 20 56 64 62 65 20 2a 76 20 3d 20 {. Vdbe *v =
1990: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 23 69 (Vdbe*)pStmt;.#i
19a0: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 f SQLITE_THREADS
19b0: 41 46 45 0a 20 20 20 20 73 71 6c 69 74 65 33 5f AFE. sqlite3_
19c0: 6d 75 74 65 78 20 2a 6d 75 74 65 78 20 3d 20 76 mutex *mutex = v
19d0: 2d 3e 64 62 2d 3e 6d 75 74 65 78 3b 0a 23 65 6e ->db->mutex;.#en
19e0: 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33 5f dif. sqlite3_
19f0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
1a00: 78 29 3b 0a 20 20 20 20 73 74 6d 74 4c 72 75 52 x);. stmtLruR
1a10: 65 6d 6f 76 65 28 76 29 3b 0a 20 20 20 20 72 63 emove(v);. rc
1a20: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 = sqlite3VdbeFi
1a30: 6e 61 6c 69 7a 65 28 76 29 3b 0a 20 20 20 20 73 nalize(v);. s
1a40: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1a50: 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 ve(mutex);. }.
1a60: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1a70: 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 *.** Terminate t
1a80: 68 65 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 he current execu
1a90: 74 69 6f 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 tion of an SQL s
1aa0: 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 tatement and res
1ab0: 65 74 20 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f et it.** back to
1ac0: 20 69 74 73 20 73 74 61 72 74 69 6e 67 20 73 74 its starting st
1ad0: 61 74 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 ate so that it c
1ae0: 61 6e 20 62 65 20 72 65 75 73 65 64 2e 20 41 20 an be reused. A
1af0: 73 75 63 63 65 73 73 20 63 6f 64 65 20 66 72 6f success code fro
1b00: 6d 0a 2a 2a 20 74 68 65 20 70 72 69 6f 72 20 65 m.** the prior e
1b10: 78 65 63 75 74 69 6f 6e 20 69 73 20 72 65 74 75 xecution is retu
1b20: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 rned..**.** This
1b30: 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 routine sets th
1b40: 65 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 e error code and
1b50: 20 73 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 string returned
1b60: 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 by.** sqlite3_e
1b70: 72 72 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 rrcode(), sqlite
1b80: 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 3_errmsg() and s
1b90: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 qlite3_errmsg16(
1ba0: 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 )..*/.int sqlite
1bb0: 33 5f 72 65 73 65 74 28 73 71 6c 69 74 65 33 5f 3_reset(sqlite3_
1bc0: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 stmt *pStmt){.
1bd0: 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 70 53 int rc;. if( pS
1be0: 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 tmt==0 ){. rc
1bf0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1c00: 7d 65 6c 73 65 7b 0a 20 20 20 20 56 64 62 65 20 }else{. Vdbe
1c10: 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d *v = (Vdbe*)pStm
1c20: 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d t;. sqlite3_m
1c30: 75 74 65 78 5f 65 6e 74 65 72 28 76 2d 3e 64 62 utex_enter(v->db
1c40: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 63 ->mutex);. rc
1c50: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 = sqlite3VdbeRe
1c60: 73 65 74 28 76 29 3b 0a 20 20 20 20 73 74 6d 74 set(v);. stmt
1c70: 4c 72 75 41 64 64 28 76 29 3b 0a 20 20 20 20 73 LruAdd(v);. s
1c80: 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 qlite3VdbeMakeRe
1c90: 61 64 79 28 76 2c 20 2d 31 2c 20 30 2c 20 30 2c ady(v, -1, 0, 0,
1ca0: 20 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0);. assert(
1cb0: 20 28 72 63 20 26 20 28 76 2d 3e 64 62 2d 3e 65 (rc & (v->db->e
1cc0: 72 72 4d 61 73 6b 29 29 3d 3d 72 63 20 29 3b 0a rrMask))==rc );.
1cd0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
1ce0: 78 5f 6c 65 61 76 65 28 76 2d 3e 64 62 2d 3e 6d x_leave(v->db->m
1cf0: 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 utex);. }. ret
1d00: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1d10: 20 53 65 74 20 61 6c 6c 20 74 68 65 20 70 61 72 Set all the par
1d20: 61 6d 65 74 65 72 73 20 69 6e 20 74 68 65 20 63 ameters in the c
1d30: 6f 6d 70 69 6c 65 64 20 53 51 4c 20 73 74 61 74 ompiled SQL stat
1d40: 65 6d 65 6e 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a ement to NULL..*
1d50: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c /.int sqlite3_cl
1d60: 65 61 72 5f 62 69 6e 64 69 6e 67 73 28 73 71 6c ear_bindings(sql
1d70: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
1d80: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e ){. int i;. in
1d90: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
1da0: 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 ;. Vdbe *p = (V
1db0: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 23 69 66 20 dbe*)pStmt;.#if
1dc0: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 SQLITE_THREADSAF
1dd0: 45 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 E. sqlite3_mute
1de0: 78 20 2a 6d 75 74 65 78 20 3d 20 28 28 56 64 62 x *mutex = ((Vdb
1df0: 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 2d 3e 6d e*)pStmt)->db->m
1e00: 75 74 65 78 3b 0a 23 65 6e 64 69 66 0a 20 20 73 utex;.#endif. s
1e10: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
1e20: 65 72 28 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 er(mutex);. for
1e30: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b (i=0; i<p->nVar;
1e40: 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 i++){. sqlit
1e50: 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 e3VdbeMemRelease
1e60: 28 26 70 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 (&p->aVar[i]);.
1e70: 20 20 20 70 2d 3e 61 56 61 72 5b 69 5d 2e 66 6c p->aVar[i].fl
1e80: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a ags = MEM_Null;.
1e90: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
1ea0: 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 29 tex_leave(mutex)
1eb0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1ec0: 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .../************
1ed0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1ee0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 20 sqlite3_value_
1ef0: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
1f00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f10: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
1f20: 67 20 72 6f 75 74 69 6e 65 73 20 65 78 74 72 61 g routines extra
1f30: 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 ct information f
1f40: 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20 73 71 6c rom a Mem or sql
1f50: 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a 20 73 74 ite3_value.** st
1f60: 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f 6e 73 ructure..*/.cons
1f70: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f t void *sqlite3_
1f80: 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71 6c 69 74 value_blob(sqlit
1f90: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b e3_value *pVal){
1fa0: 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d 65 6d . Mem *p = (Mem
1fb0: 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20 70 2d *)pVal;. if( p-
1fc0: 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d 5f 42 6c >flags & (MEM_Bl
1fd0: 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29 7b 0a 20 ob|MEM_Str) ){.
1fe0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 sqlite3VdbeMe
1ff0: 6d 45 78 70 61 6e 64 42 6c 6f 62 28 70 29 3b 0a mExpandBlob(p);.
2000: 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 26 3d 20 p->flags &=
2010: 7e 4d 45 4d 5f 53 74 72 3b 0a 20 20 20 20 70 2d ~MEM_Str;. p-
2020: 3e 66 6c 61 67 73 20 7c 3d 20 4d 45 4d 5f 42 6c >flags |= MEM_Bl
2030: 6f 62 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 ob;. return p
2040: 2d 3e 7a 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 ->z;. }else{.
2050: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
2060: 5f 76 61 6c 75 65 5f 74 65 78 74 28 70 56 61 6c _value_text(pVal
2070: 29 3b 0a 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c );. }.}.int sql
2080: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 ite3_value_bytes
2090: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a (sqlite3_value *
20a0: 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 pVal){. return
20b0: 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 sqlite3ValueByte
20c0: 73 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 s(pVal, SQLITE_U
20d0: 54 46 38 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 TF8);.}.int sqli
20e0: 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 te3_value_bytes1
20f0: 36 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 6(sqlite3_value
2100: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e *pVal){. return
2110: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 sqlite3ValueByt
2120: 65 73 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f es(pVal, SQLITE_
2130: 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a UTF16NATIVE);.}.
2140: 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 76 double sqlite3_v
2150: 61 6c 75 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69 alue_double(sqli
2160: 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 te3_value *pVal)
2170: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 {. return sqlit
2180: 65 33 56 64 62 65 52 65 61 6c 56 61 6c 75 65 28 e3VdbeRealValue(
2190: 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 (Mem*)pVal);.}.i
21a0: 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt sqlite3_value
21b0: 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 76 61 6c _int(sqlite3_val
21c0: 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 ue *pVal){. ret
21d0: 75 72 6e 20 28 69 6e 74 29 73 71 6c 69 74 65 33 urn (int)sqlite3
21e0: 56 64 62 65 49 6e 74 56 61 6c 75 65 28 28 4d 65 VdbeIntValue((Me
21f0: 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 73 71 6c 69 m*)pVal);.}.sqli
2200: 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 te_int64 sqlite3
2210: 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 73 71 6c _value_int64(sql
2220: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c ite3_value *pVal
2230: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
2240: 74 65 33 56 64 62 65 49 6e 74 56 61 6c 75 65 28 te3VdbeIntValue(
2250: 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 63 (Mem*)pVal);.}.c
2260: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
2270: 61 72 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 ar *sqlite3_valu
2280: 65 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f 76 e_text(sqlite3_v
2290: 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 alue *pVal){. r
22a0: 65 74 75 72 6e 20 28 63 6f 6e 73 74 20 75 6e 73 eturn (const uns
22b0: 69 67 6e 65 64 20 63 68 61 72 20 2a 29 73 71 6c igned char *)sql
22c0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
22d0: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 al, SQLITE_UTF8)
22e0: 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ;.}.#ifndef SQLI
22f0: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f TE_OMIT_UTF16.co
2300: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 nst void *sqlite
2310: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 3_value_text16(s
2320: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 qlite3_value* pV
2330: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 al){. return sq
2340: 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 lite3ValueText(p
2350: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 Val, SQLITE_UTF1
2360: 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 6NATIVE);.}.cons
2370: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f t void *sqlite3_
2380: 76 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28 73 value_text16be(s
2390: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
23a0: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 al){. return sq
23b0: 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 lite3ValueText(p
23c0: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 Val, SQLITE_UTF1
23d0: 36 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 6BE);.}.const vo
23e0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 id *sqlite3_valu
23f0: 65 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69 74 e_text16le(sqlit
2400: 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b e3_value *pVal){
2410: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
2420: 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 3ValueText(pVal,
2430: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 SQLITE_UTF16LE)
2440: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
2450: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 LITE_OMIT_UTF16
2460: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 */.int sqlite3_v
2470: 61 6c 75 65 5f 74 79 70 65 28 73 71 6c 69 74 65 alue_type(sqlite
2480: 33 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 3_value* pVal){.
2490: 20 20 72 65 74 75 72 6e 20 70 56 61 6c 2d 3e 74 return pVal->t
24a0: 79 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a ype;.}../*******
24b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
24c0: 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 ***** sqlite3_re
24d0: 73 75 6c 74 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a sult_ *********
24e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
24f0: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f ******.** The fo
2500: 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 llowing routines
2510: 20 61 72 65 20 75 73 65 64 20 62 79 20 75 73 65 are used by use
2520: 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 r-defined functi
2530: 6f 6e 73 20 74 6f 20 73 70 65 63 69 66 79 0a 2a ons to specify.*
2540: 2a 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 * the function r
2550: 65 73 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 esult..*/.void s
2560: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62 6c qlite3_result_bl
2570: 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f ob(. sqlite3_co
2580: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 ntext *pCtx, .
2590: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a const void *z, .
25a0: 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 int n, . void
25b0: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 (*xDel)(void *)
25c0: 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e 3e .){. assert( n>
25d0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
25e0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
25f0: 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d ld(pCtx->s.db->m
2600: 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 utex) );. sqlit
2610: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 e3VdbeMemSetStr(
2620: 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 &pCtx->s, z, n,
2630: 30 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 0, xDel);.}.void
2640: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
2650: 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 63 double(sqlite3_c
2660: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 64 6f ontext *pCtx, do
2670: 75 62 6c 65 20 72 56 61 6c 29 7b 0a 20 20 61 73 uble rVal){. as
2680: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
2690: 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 tex_held(pCtx->s
26a0: 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 .db->mutex) );.
26b0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 sqlite3VdbeMemS
26c0: 65 74 44 6f 75 62 6c 65 28 26 70 43 74 78 2d 3e etDouble(&pCtx->
26d0: 73 2c 20 72 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 s, rVal);.}.void
26e0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
26f0: 65 72 72 6f 72 28 73 71 6c 69 74 65 33 5f 63 6f error(sqlite3_co
2700: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f 6e ntext *pCtx, con
2710: 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 st char *z, int
2720: 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 n){. assert( sq
2730: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
2740: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 (pCtx->s.db->mut
2750: 65 78 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e 69 ex) );. pCtx->i
2760: 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45 5f sError = SQLITE_
2770: 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69 74 65 33 ERROR;. sqlite3
2780: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 VdbeMemSetStr(&p
2790: 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 Ctx->s, z, n, SQ
27a0: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 LITE_UTF8, SQLIT
27b0: 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 7d 0a E_TRANSIENT);.}.
27c0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
27d0: 4d 49 54 5f 55 54 46 31 36 0a 76 6f 69 64 20 73 MIT_UTF16.void s
27e0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 qlite3_result_er
27f0: 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f 63 6f ror16(sqlite3_co
2800: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f 6e ntext *pCtx, con
2810: 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74 20 st void *z, int
2820: 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 n){. assert( sq
2830: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
2840: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 (pCtx->s.db->mut
2850: 65 78 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e 69 ex) );. pCtx->i
2860: 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45 5f sError = SQLITE_
2870: 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69 74 65 33 ERROR;. sqlite3
2880: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 VdbeMemSetStr(&p
2890: 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 Ctx->s, z, n, SQ
28a0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
28b0: 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 , SQLITE_TRANSIE
28c0: 4e 54 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 76 6f NT);.}.#endif.vo
28d0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c id sqlite3_resul
28e0: 74 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f t_int(sqlite3_co
28f0: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 ntext *pCtx, int
2900: 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 iVal){. assert
2910: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2920: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d held(pCtx->s.db-
2930: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
2940: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e ite3VdbeMemSetIn
2950: 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 28 69 t64(&pCtx->s, (i
2960: 36 34 29 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 64)iVal);.}.void
2970: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
2980: 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 63 6f int64(sqlite3_co
2990: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 36 34 ntext *pCtx, i64
29a0: 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 iVal){. assert
29b0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
29c0: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d held(pCtx->s.db-
29d0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
29e0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e ite3VdbeMemSetIn
29f0: 74 36 34 28 26 70 43 74 78 2d 3e 73 2c 20 69 56 t64(&pCtx->s, iV
2a00: 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 al);.}.void sqli
2a10: 74 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 te3_result_null(
2a20: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
2a30: 2a 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74 *pCtx){. assert
2a40: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2a50: 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d held(pCtx->s.db-
2a60: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
2a70: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e 75 ite3VdbeMemSetNu
2a80: 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b 0a 7d 0a ll(&pCtx->s);.}.
2a90: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 void sqlite3_res
2aa0: 75 6c 74 5f 74 65 78 74 28 0a 20 20 73 71 6c 69 ult_text(. sqli
2ab0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 te3_context *pCt
2ac0: 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 x, . const char
2ad0: 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 0a 20 *z, . int n,.
2ae0: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f void (*xDel)(vo
2af0: 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 id *).){. asser
2b00: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
2b10: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 _held(pCtx->s.db
2b20: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 ->mutex) );. sq
2b30: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 lite3VdbeMemSetS
2b40: 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 tr(&pCtx->s, z,
2b50: 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 n, SQLITE_UTF8,
2b60: 78 44 65 6c 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 xDel);.}.#ifndef
2b70: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
2b80: 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 16.void sqlite3_
2b90: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a 20 result_text16(.
2ba0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 sqlite3_context
2bb0: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 *pCtx, . const
2bc0: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 void *z, . int
2bd0: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 n, . void (*xD
2be0: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 el)(void *).){.
2bf0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2c00: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 _mutex_held(pCtx
2c10: 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ->s.db->mutex) )
2c20: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d ;. sqlite3VdbeM
2c30: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e emSetStr(&pCtx->
2c40: 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f s, z, n, SQLITE_
2c50: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 78 44 65 UTF16NATIVE, xDe
2c60: 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 l);.}.void sqlit
2c70: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 e3_result_text16
2c80: 62 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f be(. sqlite3_co
2c90: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 ntext *pCtx, .
2ca0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a const void *z, .
2cb0: 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 int n, . void
2cc0: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 (*xDel)(void *)
2cd0: 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 .){. assert( sq
2ce0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
2cf0: 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 (pCtx->s.db->mut
2d00: 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 ex) );. sqlite3
2d10: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 VdbeMemSetStr(&p
2d20: 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 51 Ctx->s, z, n, SQ
2d30: 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 78 44 LITE_UTF16BE, xD
2d40: 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 el);.}.void sqli
2d50: 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 te3_result_text1
2d60: 36 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6le(. sqlite3_c
2d70: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 ontext *pCtx, .
2d80: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 const void *z,
2d90: 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 . int n, . voi
2da0: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a d (*xDel)(void *
2db0: 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 ).){. assert( s
2dc0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2dd0: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 d(pCtx->s.db->mu
2de0: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
2df0: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 26 3VdbeMemSetStr(&
2e00: 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 53 pCtx->s, z, n, S
2e10: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 78 QLITE_UTF16LE, x
2e20: 44 65 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f Del);.}.#endif /
2e30: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
2e40: 46 31 36 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 F16 */.void sqli
2e50: 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75 65 te3_result_value
2e60: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
2e70: 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65 33 5f *pCtx, sqlite3_
2e80: 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b 0a value *pValue){.
2e90: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
2ea0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 3_mutex_held(pCt
2eb0: 78 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 78 29 20 x->s.db->mutex)
2ec0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 );. sqlite3Vdbe
2ed0: 4d 65 6d 43 6f 70 79 28 26 70 43 74 78 2d 3e 73 MemCopy(&pCtx->s
2ee0: 2c 20 70 56 61 6c 75 65 29 3b 0a 7d 0a 76 6f 69 , pValue);.}.voi
2ef0: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 d sqlite3_result
2f00: 5f 7a 65 72 6f 62 6c 6f 62 28 73 71 6c 69 74 65 _zeroblob(sqlite
2f10: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 3_context *pCtx,
2f20: 20 69 6e 74 20 6e 29 7b 0a 20 20 61 73 73 65 72 int n){. asser
2f30: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
2f40: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 _held(pCtx->s.db
2f50: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 ->mutex) );. sq
2f60: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 5a lite3VdbeMemSetZ
2f70: 65 72 6f 42 6c 6f 62 28 26 70 43 74 78 2d 3e 73 eroBlob(&pCtx->s
2f80: 2c 20 6e 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c , n);.}.void sql
2f90: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f ite3_result_erro
2fa0: 72 5f 63 6f 64 65 28 73 71 6c 69 74 65 33 5f 63 r_code(sqlite3_c
2fb0: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e ontext *pCtx, in
2fc0: 74 20 65 72 72 43 6f 64 65 29 7b 0a 20 20 70 43 t errCode){. pC
2fd0: 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 65 72 tx->isError = er
2fe0: 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 rCode;.}../* For
2ff0: 63 65 20 61 6e 20 53 51 4c 49 54 45 5f 54 4f 4f ce an SQLITE_TOO
3000: 42 49 47 20 65 72 72 6f 72 2e 20 2a 2f 0a 76 6f BIG error. */.vo
3010: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c id sqlite3_resul
3020: 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 67 28 73 t_error_toobig(s
3030: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
3040: 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74 28 pCtx){. assert(
3050: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
3060: 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e eld(pCtx->s.db->
3070: 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 43 74 78 mutex) );. pCtx
3080: 2d 3e 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 ->isError = SQLI
3090: 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20 73 71 6c TE_TOOBIG;. sql
30a0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 ite3VdbeMemSetSt
30b0: 72 28 26 70 43 74 78 2d 3e 73 2c 20 22 73 74 72 r(&pCtx->s, "str
30c0: 69 6e 67 20 6f 72 20 62 6c 6f 62 20 74 6f 6f 20 ing or blob too
30d0: 62 69 67 22 2c 20 2d 31 2c 20 0a 20 20 20 20 20 big", -1, .
30e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30f0: 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 SQLITE_UTF8, S
3100: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 7d QLITE_STATIC);.}
3110: 0a 0a 2f 2a 20 41 6e 20 53 51 4c 49 54 45 5f 4e ../* An SQLITE_N
3120: 4f 4d 45 4d 20 65 72 72 6f 72 2e 20 2a 2f 0a 76 OMEM error. */.v
3130: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 oid sqlite3_resu
3140: 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 6d 28 73 lt_error_nomem(s
3150: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
3160: 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74 28 pCtx){. assert(
3170: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
3180: 65 6c 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e eld(pCtx->s.db->
3190: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
31a0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e 75 6c te3VdbeMemSetNul
31b0: 6c 28 26 70 43 74 78 2d 3e 73 29 3b 0a 20 20 70 l(&pCtx->s);. p
31c0: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 53 Ctx->isError = S
31d0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 70 QLITE_NOMEM;. p
31e0: 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 61 6c 6c 6f Ctx->s.db->mallo
31f0: 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 7d 0a 0a cFailed = 1;.}..
3200: 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65 20 74 68 /*.** Execute th
3210: 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d e statement pStm
3220: 74 2c 20 65 69 74 68 65 72 20 75 6e 74 69 6c 20 t, either until
3230: 61 20 72 6f 77 20 6f 66 20 64 61 74 61 20 69 73 a row of data is
3240: 20 72 65 61 64 79 2c 20 74 68 65 0a 2a 2a 20 73 ready, the.** s
3250: 74 61 74 65 6d 65 6e 74 20 69 73 20 63 6f 6d 70 tatement is comp
3260: 6c 65 74 65 6c 79 20 65 78 65 63 75 74 65 64 20 letely executed
3270: 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 or an error occu
3280: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 rs..**.** This r
3290: 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 outine implement
32a0: 73 20 74 68 65 20 62 75 6c 6b 20 6f 66 20 74 68 s the bulk of th
32b0: 65 20 6c 6f 67 69 63 20 62 65 68 69 6e 64 20 74 e logic behind t
32c0: 68 65 20 73 71 6c 69 74 65 5f 73 74 65 70 28 29 he sqlite_step()
32d0: 0a 2a 2a 20 41 50 49 2e 20 20 54 68 65 20 6f 6e .** API. The on
32e0: 6c 79 20 74 68 69 6e 67 20 6f 6d 69 74 74 65 64 ly thing omitted
32f0: 20 69 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 is the automati
3300: 63 20 72 65 63 6f 6d 70 69 6c 65 20 69 66 20 61 c recompile if a
3310: 20 0a 2a 2a 20 73 63 68 65 6d 61 20 63 68 61 6e .** schema chan
3320: 67 65 20 68 61 73 20 6f 63 63 75 72 72 65 64 2e ge has occurred.
3330: 20 20 54 68 61 74 20 64 65 74 61 69 6c 20 69 73 That detail is
3340: 20 68 61 6e 64 6c 65 64 20 62 79 20 74 68 65 0a handled by the.
3350: 2a 2a 20 6f 75 74 65 72 20 73 71 6c 69 74 65 33 ** outer sqlite3
3360: 5f 73 74 65 70 28 29 20 77 72 61 70 70 65 72 20 _step() wrapper
3370: 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2f 0a 73 74 procedure..*/.st
3380: 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 atic int sqlite3
3390: 53 74 65 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 Step(Vdbe *p){.
33a0: 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 sqlite3 *db;.
33b0: 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
33c0: 74 28 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6d t(p);. if( p->m
33d0: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 agic!=VDBE_MAGIC
33e0: 5f 52 55 4e 20 29 7b 0a 20 20 20 20 72 65 74 75 _RUN ){. retu
33f0: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
3400: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 73 73 65 ;. }.. /* Asse
3410: 72 74 20 74 68 61 74 20 6d 61 6c 6c 6f 63 28 29 rt that malloc()
3420: 20 68 61 73 20 6e 6f 74 20 66 61 69 6c 65 64 20 has not failed
3430: 2a 2f 0a 20 20 64 62 20 3d 20 70 2d 3e 64 62 3b */. db = p->db;
3440: 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f . if( db->mallo
3450: 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 cFailed ){. r
3460: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
3470: 45 4d 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 EM;. }.. if( p
3480: 2d 3e 70 63 3c 3d 30 20 26 26 20 70 2d 3e 65 78 ->pc<=0 && p->ex
3490: 70 69 72 65 64 20 29 7b 0a 20 20 20 20 69 66 28 pired ){. if(
34a0: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f p->rc==SQLITE_O
34b0: 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 72 63 K ){. p->rc
34c0: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 = SQLITE_SCHEMA
34d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d ;. }. rc =
34e0: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
34f0: 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6f 66 5f 73 goto end_of_s
3500: 74 65 70 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 tep;. }. if( s
3510: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 qlite3SafetyOn(d
3520: 62 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 b) ){. p->rc
3530: 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b = SQLITE_MISUSE;
3540: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
3550: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 TE_MISUSE;. }.
3560: 20 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a if( p->pc<0 ){.
3570: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 /* If there
3580: 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 73 74 61 are no other sta
3590: 74 65 6d 65 6e 74 73 20 63 75 72 72 65 6e 74 6c tements currentl
35a0: 79 20 72 75 6e 6e 69 6e 67 2c 20 74 68 65 6e 0a y running, then.
35b0: 20 20 20 20 2a 2a 20 72 65 73 65 74 20 74 68 65 ** reset the
35c0: 20 69 6e 74 65 72 72 75 70 74 20 66 6c 61 67 2e interrupt flag.
35d0: 20 20 54 68 69 73 20 70 72 65 76 65 6e 74 73 20 This prevents
35e0: 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 a call to sqlite
35f0: 33 5f 69 6e 74 65 72 72 75 70 74 0a 20 20 20 20 3_interrupt.
3600: 2a 2a 20 66 72 6f 6d 20 69 6e 74 65 72 72 75 70 ** from interrup
3610: 74 69 6e 67 20 61 20 73 74 61 74 65 6d 65 6e 74 ting a statement
3620: 20 74 68 61 74 20 68 61 73 20 6e 6f 74 20 79 65 that has not ye
3630: 74 20 73 74 61 72 74 65 64 2e 0a 20 20 20 20 2a t started.. *
3640: 2f 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 63 /. if( db->ac
3650: 74 69 76 65 56 64 62 65 43 6e 74 3d 3d 30 20 29 tiveVdbeCnt==0 )
3660: 7b 0a 20 20 20 20 20 20 64 62 2d 3e 75 31 2e 69 {. db->u1.i
3670: 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d 20 30 sInterrupted = 0
3680: 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 6e 64 65 66 ;. }..#ifndef
3690: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 SQLITE_OMIT_TRA
36a0: 43 45 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 78 CE. if( db->x
36b0: 50 72 6f 66 69 6c 65 20 26 26 20 21 64 62 2d 3e Profile && !db->
36c0: 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 init.busy ){.
36d0: 20 20 20 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a double rNow;.
36e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
36f0: 75 72 72 65 6e 74 54 69 6d 65 28 64 62 2d 3e 70 urrentTime(db->p
3700: 56 66 73 2c 20 26 72 4e 6f 77 29 3b 0a 20 20 20 Vfs, &rNow);.
3710: 20 20 20 70 2d 3e 73 74 61 72 74 54 69 6d 65 20 p->startTime
3720: 3d 20 28 75 36 34 29 28 28 72 4e 6f 77 20 2d 20 = (u64)((rNow -
3730: 28 69 6e 74 29 72 4e 6f 77 29 2a 33 36 30 30 2e (int)rNow)*3600.
3740: 30 2a 32 34 2e 30 2a 31 30 30 30 30 30 30 30 30 0*24.0*100000000
3750: 30 2e 30 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 0.0);. }.#end
3760: 69 66 0a 0a 20 20 20 20 64 62 2d 3e 61 63 74 69 if.. db->acti
3770: 76 65 56 64 62 65 43 6e 74 2b 2b 3b 0a 20 20 20 veVdbeCnt++;.
3780: 20 69 66 28 20 70 2d 3e 72 65 61 64 4f 6e 6c 79 if( p->readOnly
3790: 3d 3d 30 20 29 20 64 62 2d 3e 77 72 69 74 65 56 ==0 ) db->writeV
37a0: 64 62 65 43 6e 74 2b 2b 3b 0a 20 20 20 20 70 2d dbeCnt++;. p-
37b0: 3e 70 63 20 3d 20 30 3b 0a 20 20 20 20 73 74 6d >pc = 0;. stm
37c0: 74 4c 72 75 52 65 6d 6f 76 65 28 70 29 3b 0a 20 tLruRemove(p);.
37d0: 20 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }.#ifndef SQLIT
37e0: 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 E_OMIT_EXPLAIN.
37f0: 20 69 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 if( p->explain
3800: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
3810: 74 65 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a te3VdbeList(p);.
3820: 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f }else.#endif /
3830: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 * SQLITE_OMIT_EX
3840: 50 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 PLAIN */. {.
3850: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 rc = sqlite3Vdb
3860: 65 45 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 eExec(p);. }..
3870: 20 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 if( sqlite3Safe
3880: 74 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 tyOff(db) ){.
3890: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 rc = SQLITE_MIS
38a0: 55 53 45 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 USE;. }..#ifnde
38b0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 f SQLITE_OMIT_TR
38c0: 41 43 45 0a 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 ACE. /* Invoke
38d0: 74 68 65 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c the profile call
38e0: 62 61 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 back if there is
38f0: 20 6f 6e 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 one. */. if(
3900: 72 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 rc!=SQLITE_ROW &
3910: 26 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 26 & db->xProfile &
3920: 26 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 & !db->init.busy
3930: 20 26 26 20 70 2d 3e 7a 53 71 6c 20 29 7b 0a 20 && p->zSql ){.
3940: 20 20 20 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a double rNow;.
3950: 20 20 20 20 75 36 34 20 65 6c 61 70 73 65 54 69 u64 elapseTi
3960: 6d 65 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 me;.. sqlite3
3970: 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 28 64 62 OsCurrentTime(db
3980: 2d 3e 70 56 66 73 2c 20 26 72 4e 6f 77 29 3b 0a ->pVfs, &rNow);.
3990: 20 20 20 20 65 6c 61 70 73 65 54 69 6d 65 20 3d elapseTime =
39a0: 20 28 75 36 34 29 28 28 72 4e 6f 77 20 2d 20 28 (u64)((rNow - (
39b0: 69 6e 74 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 int)rNow)*3600.0
39c0: 2a 32 34 2e 30 2a 31 30 30 30 30 30 30 30 30 30 *24.0*1000000000
39d0: 2e 30 29 3b 0a 20 20 20 20 65 6c 61 70 73 65 54 .0);. elapseT
39e0: 69 6d 65 20 2d 3d 20 70 2d 3e 73 74 61 72 74 54 ime -= p->startT
39f0: 69 6d 65 3b 0a 20 20 20 20 64 62 2d 3e 78 50 72 ime;. db->xPr
3a00: 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72 6f 66 69 ofile(db->pProfi
3a10: 6c 65 41 72 67 2c 20 70 2d 3e 7a 53 71 6c 2c 20 leArg, p->zSql,
3a20: 65 6c 61 70 73 65 54 69 6d 65 29 3b 0a 20 20 7d elapseTime);. }
3a30: 0a 23 65 6e 64 69 66 0a 0a 20 20 64 62 2d 3e 65 .#endif.. db->e
3a40: 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20 2f rrCode = rc;. /
3a50: 2a 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d *sqlite3Error(p-
3a60: 3e 64 62 2c 20 72 63 2c 20 30 29 3b 2a 2f 0a 20 >db, rc, 0);*/.
3a70: 20 70 2d 3e 72 63 20 3d 20 73 71 6c 69 74 65 33 p->rc = sqlite3
3a80: 41 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 70 ApiExit(p->db, p
3a90: 2d 3e 72 63 29 3b 0a 65 6e 64 5f 6f 66 5f 73 74 ->rc);.end_of_st
3aa0: 65 70 3a 0a 20 20 61 73 73 65 72 74 28 20 28 72 ep:. assert( (r
3ab0: 63 26 30 78 66 66 29 3d 3d 72 63 20 29 3b 0a 20 c&0xff)==rc );.
3ac0: 20 69 66 28 20 70 2d 3e 69 73 50 72 65 70 61 72 if( p->isPrepar
3ad0: 65 56 32 20 26 26 20 28 72 63 26 30 78 66 66 29 eV2 && (rc&0xff)
3ae0: 3c 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a 20 <SQLITE_ROW ){.
3af0: 20 20 20 2f 2a 20 54 68 69 73 20 62 65 68 61 76 /* This behav
3b00: 69 6f 72 20 6f 63 63 75 72 73 20 69 66 20 73 71 ior occurs if sq
3b10: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 lite3_prepare_v2
3b20: 28 29 20 77 61 73 20 75 73 65 64 20 74 6f 20 62 () was used to b
3b30: 75 69 6c 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 uild. ** the
3b40: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
3b50: 6e 74 2e 20 20 52 65 74 75 72 6e 20 65 72 72 6f nt. Return erro
3b60: 72 20 63 6f 64 65 73 20 64 69 72 65 63 74 6c 79 r codes directly
3b70: 20 2a 2f 0a 20 20 20 20 70 2d 3e 64 62 2d 3e 65 */. p->db->e
3b80: 72 72 43 6f 64 65 20 3d 20 70 2d 3e 72 63 3b 0a rrCode = p->rc;.
3b90: 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 45 72 /* sqlite3Er
3ba0: 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 ror(p->db, p->rc
3bb0: 2c 20 30 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 , 0); */. ret
3bc0: 75 72 6e 20 70 2d 3e 72 63 3b 0a 20 20 7d 65 6c urn p->rc;. }el
3bd0: 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 se{. /* This
3be0: 69 73 20 66 6f 72 20 6c 65 67 61 63 79 20 73 71 is for legacy sq
3bf0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 lite3_prepare()
3c00: 62 75 69 6c 64 73 20 61 6e 64 20 77 68 65 6e 20 builds and when
3c10: 74 68 65 20 63 6f 64 65 0a 20 20 20 20 2a 2a 20 the code. **
3c20: 69 73 20 53 51 4c 49 54 45 5f 52 4f 57 20 6f 72 is SQLITE_ROW or
3c30: 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 2a 2f 0a SQLITE_DONE */.
3c40: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
3c50: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 }.}../*.** This
3c60: 20 69 73 20 74 68 65 20 74 6f 70 2d 6c 65 76 65 is the top-leve
3c70: 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e l implementation
3c80: 20 6f 66 20 73 71 6c 69 74 65 33 5f 73 74 65 70 of sqlite3_step
3c90: 28 29 2e 20 20 43 61 6c 6c 0a 2a 2a 20 73 71 6c (). Call.** sql
3ca0: 69 74 65 33 53 74 65 70 28 29 20 74 6f 20 64 6f ite3Step() to do
3cb0: 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 77 6f 72 most of the wor
3cc0: 6b 2e 20 20 49 66 20 61 20 73 63 68 65 6d 61 20 k. If a schema
3cd0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 0a 2a 2a error occurs,.**
3ce0: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 52 65 70 call sqlite3Rep
3cf0: 72 65 70 61 72 65 28 29 20 61 6e 64 20 74 72 79 repare() and try
3d00: 20 61 67 61 69 6e 2e 0a 2a 2f 0a 23 69 66 64 65 again..*/.#ifde
3d10: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 f SQLITE_OMIT_PA
3d20: 52 53 45 52 0a 69 6e 74 20 73 71 6c 69 74 65 33 RSER.int sqlite3
3d30: 5f 73 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74 _step(sqlite3_st
3d40: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e mt *pStmt){. in
3d50: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 t rc = SQLITE_MI
3d60: 53 55 53 45 3b 0a 20 20 69 66 28 20 70 53 74 6d SUSE;. if( pStm
3d70: 74 20 29 7b 0a 20 20 20 20 56 64 62 65 20 2a 76 t ){. Vdbe *v
3d80: 3b 0a 20 20 20 20 76 20 3d 20 28 56 64 62 65 2a ;. v = (Vdbe*
3d90: 29 70 53 74 6d 74 3b 0a 20 20 20 20 73 71 6c 69 )pStmt;. sqli
3da0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
3db0: 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 v->db->mutex);.
3dc0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 53 rc = sqlite3S
3dd0: 74 65 70 28 76 29 3b 0a 20 20 20 20 73 71 6c 69 tep(v);. sqli
3de0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
3df0: 76 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 v->db->mutex);.
3e00: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
3e10: 7d 0a 23 65 6c 73 65 0a 69 6e 74 20 73 71 6c 69 }.#else.int sqli
3e20: 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74 65 33 te3_step(sqlite3
3e30: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 _stmt *pStmt){.
3e40: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
3e50: 5f 4d 49 53 55 53 45 3b 0a 20 20 69 66 28 20 70 _MISUSE;. if( p
3e60: 53 74 6d 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 Stmt ){. int
3e70: 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 56 64 62 cnt = 0;. Vdb
3e80: 65 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53 e *v = (Vdbe*)pS
3e90: 74 6d 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 tmt;. sqlite3
3ea0: 20 2a 64 62 20 3d 20 76 2d 3e 64 62 3b 0a 20 20 *db = v->db;.
3eb0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
3ec0: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
3ed0: 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 72 63 ;. while( (rc
3ee0: 20 3d 20 73 71 6c 69 74 65 33 53 74 65 70 28 76 = sqlite3Step(v
3ef0: 29 29 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d ))==SQLITE_SCHEM
3f00: 41 0a 20 20 20 20 20 20 20 20 20 20 20 26 26 20 A. &&
3f10: 63 6e 74 2b 2b 20 3c 20 35 0a 20 20 20 20 20 20 cnt++ < 5.
3f20: 20 20 20 20 20 26 26 20 76 64 62 65 52 65 70 72 && vdbeRepr
3f30: 65 70 61 72 65 28 76 29 20 29 7b 0a 20 20 20 20 epare(v) ){.
3f40: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 sqlite3_reset(
3f50: 70 53 74 6d 74 29 3b 0a 20 20 20 20 20 20 76 2d pStmt);. v-
3f60: 3e 65 78 70 69 72 65 64 20 3d 20 30 3b 0a 20 20 >expired = 0;.
3f70: 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d }. if( rc==
3f80: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 26 26 SQLITE_SCHEMA &&
3f90: 20 76 2d 3e 69 73 50 72 65 70 61 72 65 56 32 20 v->isPrepareV2
3fa0: 26 26 20 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 && db->pErr ){.
3fb0: 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61 73 /* This cas
3fc0: 65 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 66 e occurs after f
3fd0: 61 69 6c 69 6e 67 20 74 6f 20 72 65 63 6f 6d 70 ailing to recomp
3fe0: 69 6c 65 20 61 6e 20 73 71 6c 20 73 74 61 74 65 ile an sql state
3ff0: 6d 65 6e 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 ment. . **
4000: 54 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 The error messag
4010: 65 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 20 63 e from the SQL c
4020: 6f 6d 70 69 6c 65 72 20 68 61 73 20 61 6c 72 65 ompiler has alre
4030: 61 64 79 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 ady been loaded
4040: 0a 20 20 20 20 20 20 2a 2a 20 69 6e 74 6f 20 74 . ** into t
4050: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
4060: 6c 65 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 63 le. This block c
4070: 6f 70 69 65 73 20 74 68 65 20 65 72 72 6f 72 20 opies the error
4080: 6d 65 73 73 61 67 65 20 0a 20 20 20 20 20 20 2a message . *
4090: 2a 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 * from the datab
40a0: 61 73 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f 20 ase handle into
40b0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 61 6e the statement an
40c0: 64 20 73 65 74 73 20 74 68 65 20 73 74 61 74 65 d sets the state
40d0: 6d 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 70 72 ment. ** pr
40e0: 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 74 6f ogram counter to
40f0: 20 30 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 0 to ensure tha
4100: 74 20 77 68 65 6e 20 74 68 65 20 73 74 61 74 65 t when the state
4110: 6d 65 6e 74 20 69 73 20 0a 20 20 20 20 20 20 2a ment is . *
4120: 2a 20 66 69 6e 61 6c 69 7a 65 64 20 6f 72 20 72 * finalized or r
4130: 65 73 65 74 20 74 68 65 20 70 61 72 73 65 72 20 eset the parser
4140: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 error message is
4150: 20 61 76 61 69 6c 61 62 6c 65 20 76 69 61 0a 20 available via.
4160: 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f ** sqlite3_
4170: 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71 6c errmsg() and sql
4180: 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 2e 0a ite3_errcode()..
4190: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 63 */. c
41a0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 72 72 20 onst char *zErr
41b0: 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 = (const char *)
41c0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 sqlite3_value_te
41d0: 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 20 0a 20 xt(db->pErr); .
41e0: 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 sqlite3DbFr
41f0: 65 65 28 64 62 2c 20 76 2d 3e 7a 45 72 72 4d 73 ee(db, v->zErrMs
4200: 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 64 g);. if( !d
4210: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
4220: 29 7b 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 ){. v->zE
4230: 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 44 rrMsg = sqlite3D
4240: 62 53 74 72 44 75 70 28 64 62 2c 20 7a 45 72 72 bStrDup(db, zErr
4250: 29 3b 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 20 );. } else
4260: 7b 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72 {. v->zEr
4270: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 rMsg = 0;.
4280: 20 20 76 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 v->rc = SQLITE
4290: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a _NOMEM;. }.
42a0: 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 }. rc = s
42b0: 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 qlite3ApiExit(db
42c0: 2c 20 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 , rc);. sqlit
42d0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
42e0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 b->mutex);. }.
42f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 return rc;.}.#e
4300: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 ndif../*.** Extr
4310: 61 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74 act the user dat
4320: 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 a from a sqlite3
4330: 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 _context structu
4340: 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a re and return a.
4350: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 ** pointer to it
4360: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
4370: 65 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c e3_user_data(sql
4380: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 ite3_context *p)
4390: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 {. assert( p &&
43a0: 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 p->pFunc );. r
43b0: 65 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e eturn p->pFunc->
43c0: 70 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a pUserData;.}../*
43d0: 0a 2a 2a 20 45 78 74 72 61 63 74 20 74 68 65 20 .** Extract the
43e0: 75 73 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 user data from a
43f0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 sqlite3_context
4400: 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 72 structure and r
4410: 65 74 75 72 6e 20 61 0a 2a 2a 20 70 6f 69 6e 74 eturn a.** point
4420: 65 72 20 74 6f 20 69 74 2e 0a 2a 2f 0a 73 71 6c er to it..*/.sql
4430: 69 74 65 33 20 2a 73 71 6c 69 74 65 33 5f 63 6f ite3 *sqlite3_co
4440: 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 ntext_db_handle(
4450: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
4460: 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 *p){. assert( p
4470: 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a && p->pFunc );.
4480: 20 20 72 65 74 75 72 6e 20 70 2d 3e 73 2e 64 62 return p->s.db
4490: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 ;.}../*.** The f
44a0: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 68 65 20 ollowing is the
44b0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f implementation o
44c0: 66 20 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f f an SQL functio
44d0: 6e 20 74 68 61 74 20 61 6c 77 61 79 73 0a 2a 2a n that always.**
44e0: 20 66 61 69 6c 73 20 77 69 74 68 20 61 6e 20 65 fails with an e
44f0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 73 74 61 rror message sta
4500: 74 69 6e 67 20 74 68 61 74 20 74 68 65 20 66 75 ting that the fu
4510: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 nction is used i
4520: 6e 20 74 68 65 0a 2a 2a 20 77 72 6f 6e 67 20 63 n the.** wrong c
4530: 6f 6e 74 65 78 74 2e 20 20 54 68 65 20 73 71 6c ontext. The sql
4540: 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 ite3_overload_fu
4550: 6e 63 74 69 6f 6e 28 29 20 41 50 49 20 6d 69 67 nction() API mig
4560: 68 74 20 63 6f 6e 73 74 72 75 63 74 0a 2a 2a 20 ht construct.**
4570: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 SQL function tha
4580: 74 20 75 73 65 20 74 68 69 73 20 72 6f 75 74 69 t use this routi
4590: 6e 65 20 73 6f 20 74 68 61 74 20 74 68 65 20 66 ne so that the f
45a0: 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 65 78 unctions will ex
45b0: 69 73 74 0a 2a 2a 20 66 6f 72 20 6e 61 6d 65 20 ist.** for name
45c0: 72 65 73 6f 6c 75 74 69 6f 6e 20 62 75 74 20 61 resolution but a
45d0: 72 65 20 61 63 74 75 61 6c 6c 79 20 6f 76 65 72 re actually over
45e0: 6c 6f 61 64 65 64 20 62 79 20 74 68 65 20 78 46 loaded by the xF
45f0: 69 6e 64 46 75 6e 63 74 69 6f 6e 0a 2a 2a 20 6d indFunction.** m
4600: 65 74 68 6f 64 20 6f 66 20 76 69 72 74 75 61 6c ethod of virtual
4610: 20 74 61 62 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 tables..*/.void
4620: 20 73 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 sqlite3InvalidF
4630: 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 unction(. sqlit
4640: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 e3_context *cont
4650: 65 78 74 2c 20 20 2f 2a 20 54 68 65 20 66 75 6e ext, /* The fun
4660: 63 74 69 6f 6e 20 63 61 6c 6c 69 6e 67 20 63 6f ction calling co
4670: 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 4e ntext */. int N
4680: 6f 74 55 73 65 64 2c 20 20 20 20 20 20 20 20 20 otUsed,
4690: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
46a0: 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 of arguments to
46b0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a the function */.
46c0: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 sqlite3_value
46d0: 2a 2a 4e 6f 74 55 73 65 64 32 20 20 20 2f 2a 20 **NotUsed2 /*
46e0: 56 61 6c 75 65 20 6f 66 20 65 61 63 68 20 61 72 Value of each ar
46f0: 67 75 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 63 gument */.){. c
4700: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 onst char *zName
4710: 20 3d 20 63 6f 6e 74 65 78 74 2d 3e 70 46 75 6e = context->pFun
4720: 63 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 63 68 61 72 c->zName;. char
4730: 20 2a 7a 45 72 72 3b 0a 20 20 55 4e 55 53 45 44 *zErr;. UNUSED
4740: 5f 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 _PARAMETER2(NotU
4750: 73 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a sed, NotUsed2);.
4760: 20 20 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33 zErr = sqlite3
4770: 4d 50 72 69 6e 74 66 28 30 2c 0a 20 20 20 20 20 MPrintf(0,.
4780: 20 22 75 6e 61 62 6c 65 20 74 6f 20 75 73 65 20 "unable to use
4790: 66 75 6e 63 74 69 6f 6e 20 25 73 20 69 6e 20 74 function %s in t
47a0: 68 65 20 72 65 71 75 65 73 74 65 64 20 63 6f 6e he requested con
47b0: 74 65 78 74 22 2c 20 7a 4e 61 6d 65 29 3b 0a 20 text", zName);.
47c0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
47d0: 65 72 72 6f 72 28 63 6f 6e 74 65 78 74 2c 20 7a error(context, z
47e0: 45 72 72 2c 20 2d 31 29 3b 0a 20 20 73 71 6c 69 Err, -1);. sqli
47f0: 74 65 33 5f 66 72 65 65 28 7a 45 72 72 29 3b 0a te3_free(zErr);.
4800: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 }../*.** Allocat
4810: 65 20 6f 72 20 72 65 74 75 72 6e 20 74 68 65 20 e or return the
4820: 61 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78 aggregate contex
4830: 74 20 66 6f 72 20 61 20 75 73 65 72 20 66 75 6e t for a user fun
4840: 63 74 69 6f 6e 2e 20 20 41 20 6e 65 77 0a 2a 2a ction. A new.**
4850: 20 63 6f 6e 74 65 78 74 20 69 73 20 61 6c 6c 6f context is allo
4860: 63 61 74 65 64 20 6f 6e 20 74 68 65 20 66 69 72 cated on the fir
4870: 73 74 20 63 61 6c 6c 2e 20 20 53 75 62 73 65 71 st call. Subseq
4880: 75 65 6e 74 20 63 61 6c 6c 73 20 72 65 74 75 72 uent calls retur
4890: 6e 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 63 6f n the.** same co
48a0: 6e 74 65 78 74 20 74 68 61 74 20 77 61 73 20 72 ntext that was r
48b0: 65 74 75 72 6e 65 64 20 6f 6e 20 70 72 69 6f 72 eturned on prior
48c0: 20 63 61 6c 6c 73 2e 0a 2a 2f 0a 76 6f 69 64 20 calls..*/.void
48d0: 2a 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 *sqlite3_aggrega
48e0: 74 65 5f 63 6f 6e 74 65 78 74 28 73 71 6c 69 74 te_context(sqlit
48f0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 2c 20 69 e3_context *p, i
4900: 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20 4d 65 6d nt nByte){. Mem
4910: 20 2a 70 4d 65 6d 3b 0a 20 20 61 73 73 65 72 74 *pMem;. assert
4920: 28 20 70 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 ( p && p->pFunc
4930: 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 74 && p->pFunc->xSt
4940: 65 70 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ep );. assert(
4950: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
4960: 6c 64 28 70 2d 3e 73 2e 64 62 2d 3e 6d 75 74 65 ld(p->s.db->mute
4970: 78 29 20 29 3b 0a 20 20 70 4d 65 6d 20 3d 20 70 x) );. pMem = p
4980: 2d 3e 70 4d 65 6d 3b 0a 20 20 69 66 28 20 28 70 ->pMem;. if( (p
4990: 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d Mem->flags & MEM
49a0: 5f 41 67 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 _Agg)==0 ){.
49b0: 69 66 28 20 6e 42 79 74 65 3d 3d 30 20 29 7b 0a if( nByte==0 ){.
49c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 sqlite3Vdb
49d0: 65 4d 65 6d 52 65 6c 65 61 73 65 45 78 74 65 72 eMemReleaseExter
49e0: 6e 61 6c 28 70 4d 65 6d 29 3b 0a 20 20 20 20 20 nal(pMem);.
49f0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d pMem->flags = M
4a00: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 70 EM_Null;. p
4a10: 4d 65 6d 2d 3e 7a 20 3d 20 30 3b 0a 20 20 20 20 Mem->z = 0;.
4a20: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c }else{. sql
4a30: 69 74 65 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 ite3VdbeMemGrow(
4a40: 70 4d 65 6d 2c 20 6e 42 79 74 65 2c 20 30 29 3b pMem, nByte, 0);
4a50: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 . pMem->fla
4a60: 67 73 20 3d 20 4d 45 4d 5f 41 67 67 3b 0a 20 20 gs = MEM_Agg;.
4a70: 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 70 44 65 66 pMem->u.pDef
4a80: 20 3d 20 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20 = p->pFunc;.
4a90: 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e 7a 20 29 if( pMem->z )
4aa0: 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74 {. memset
4ab0: 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c 20 6e 42 79 (pMem->z, 0, nBy
4ac0: 74 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 te);. }.
4ad0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
4ae0: 28 76 6f 69 64 2a 29 70 4d 65 6d 2d 3e 7a 3b 0a (void*)pMem->z;.
4af0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
4b00: 74 68 65 20 61 75 78 69 6c 61 72 79 20 64 61 74 the auxilary dat
4b10: 61 20 70 6f 69 6e 74 65 72 2c 20 69 66 20 61 6e a pointer, if an
4b20: 79 2c 20 66 6f 72 20 74 68 65 20 69 41 72 67 27 y, for the iArg'
4b30: 74 68 20 61 72 67 75 6d 65 6e 74 20 74 6f 0a 2a th argument to.*
4b40: 2a 20 74 68 65 20 75 73 65 72 2d 66 75 6e 63 74 * the user-funct
4b50: 69 6f 6e 20 64 65 66 69 6e 65 64 20 62 79 20 70 ion defined by p
4b60: 43 74 78 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 Ctx..*/.void *sq
4b70: 6c 69 74 65 33 5f 67 65 74 5f 61 75 78 64 61 74 lite3_get_auxdat
4b80: 61 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 a(sqlite3_contex
4b90: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 41 72 t *pCtx, int iAr
4ba0: 67 29 7b 0a 20 20 56 64 62 65 46 75 6e 63 20 2a g){. VdbeFunc *
4bb0: 70 56 64 62 65 46 75 6e 63 3b 0a 0a 20 20 61 73 pVdbeFunc;.. as
4bc0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
4bd0: 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 73 tex_held(pCtx->s
4be0: 2e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 .db->mutex) );.
4bf0: 20 70 56 64 62 65 46 75 6e 63 20 3d 20 70 43 74 pVdbeFunc = pCt
4c00: 78 2d 3e 70 56 64 62 65 46 75 6e 63 3b 0a 20 20 x->pVdbeFunc;.
4c10: 69 66 28 20 21 70 56 64 62 65 46 75 6e 63 20 7c if( !pVdbeFunc |
4c20: 7c 20 69 41 72 67 3e 3d 70 56 64 62 65 46 75 6e | iArg>=pVdbeFun
4c30: 63 2d 3e 6e 41 75 78 20 7c 7c 20 69 41 72 67 3c c->nAux || iArg<
4c40: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
4c50: 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 0;. }. return
4c60: 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 pVdbeFunc->apAux
4c70: 5b 69 41 72 67 5d 2e 70 41 75 78 3b 0a 7d 0a 0a [iArg].pAux;.}..
4c80: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 61 75 /*.** Set the au
4c90: 78 69 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e xilary data poin
4ca0: 74 65 72 20 61 6e 64 20 64 65 6c 65 74 65 20 66 ter and delete f
4cb0: 75 6e 63 74 69 6f 6e 2c 20 66 6f 72 20 74 68 65 unction, for the
4cc0: 20 69 41 72 67 27 74 68 0a 2a 2a 20 61 72 67 75 iArg'th.** argu
4cd0: 6d 65 6e 74 20 74 6f 20 74 68 65 20 75 73 65 72 ment to the user
4ce0: 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 65 -function define
4cf0: 64 20 62 79 20 70 43 74 78 2e 20 41 6e 79 20 70 d by pCtx. Any p
4d00: 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20 69 73 revious value is
4d10: 0a 2a 2a 20 64 65 6c 65 74 65 64 20 62 79 20 63 .** deleted by c
4d20: 61 6c 6c 69 6e 67 20 74 68 65 20 64 65 6c 65 74 alling the delet
4d30: 65 20 66 75 6e 63 74 69 6f 6e 20 73 70 65 63 69 e function speci
4d40: 66 69 65 64 20 77 68 65 6e 20 69 74 20 77 61 73 fied when it was
4d50: 20 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 set..*/.void sq
4d60: 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64 61 74 lite3_set_auxdat
4d70: 61 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e a(. sqlite3_con
4d80: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 text *pCtx, . i
4d90: 6e 74 20 69 41 72 67 2c 20 0a 20 20 76 6f 69 64 nt iArg, . void
4da0: 20 2a 70 41 75 78 2c 20 0a 20 20 76 6f 69 64 20 *pAux, . void
4db0: 28 2a 78 44 65 6c 65 74 65 29 28 76 6f 69 64 2a (*xDelete)(void*
4dc0: 29 0a 29 7b 0a 20 20 73 74 72 75 63 74 20 41 75 ).){. struct Au
4dd0: 78 44 61 74 61 20 2a 70 41 75 78 44 61 74 61 3b xData *pAuxData;
4de0: 0a 20 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64 . VdbeFunc *pVd
4df0: 62 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 69 41 beFunc;. if( iA
4e00: 72 67 3c 30 20 29 20 67 6f 74 6f 20 66 61 69 6c rg<0 ) goto fail
4e10: 65 64 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 ed;.. assert( s
4e20: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
4e30: 64 28 70 43 74 78 2d 3e 73 2e 64 62 2d 3e 6d 75 d(pCtx->s.db->mu
4e40: 74 65 78 29 20 29 3b 0a 20 20 70 56 64 62 65 46 tex) );. pVdbeF
4e50: 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 unc = pCtx->pVdb
4e60: 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 eFunc;. if( !pV
4e70: 64 62 65 46 75 6e 63 20 7c 7c 20 70 56 64 62 65 dbeFunc || pVdbe
4e80: 46 75 6e 63 2d 3e 6e 41 75 78 3c 3d 69 41 72 67 Func->nAux<=iArg
4e90: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41 75 78 ){. int nAux
4ea0: 20 3d 20 28 70 56 64 62 65 46 75 6e 63 20 3f 20 = (pVdbeFunc ?
4eb0: 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 pVdbeFunc->nAux
4ec0: 3a 20 30 29 3b 0a 20 20 20 20 69 6e 74 20 6e 4d : 0);. int nM
4ed0: 61 6c 6c 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 alloc = sizeof(V
4ee0: 64 62 65 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f dbeFunc) + sizeo
4ef0: 66 28 73 74 72 75 63 74 20 41 75 78 44 61 74 61 f(struct AuxData
4f00: 29 2a 69 41 72 67 3b 0a 20 20 20 20 70 56 64 62 )*iArg;. pVdb
4f10: 65 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 44 eFunc = sqlite3D
4f20: 62 52 65 61 6c 6c 6f 63 28 70 43 74 78 2d 3e 73 bRealloc(pCtx->s
4f30: 2e 64 62 2c 20 70 56 64 62 65 46 75 6e 63 2c 20 .db, pVdbeFunc,
4f40: 6e 4d 61 6c 6c 6f 63 29 3b 0a 20 20 20 20 69 66 nMalloc);. if
4f50: 28 20 21 70 56 64 62 65 46 75 6e 63 20 29 7b 0a ( !pVdbeFunc ){.
4f60: 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
4f70: 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 74 d;. }. pCt
4f80: 78 2d 3e 70 56 64 62 65 46 75 6e 63 20 3d 20 70 x->pVdbeFunc = p
4f90: 56 64 62 65 46 75 6e 63 3b 0a 20 20 20 20 6d 65 VdbeFunc;. me
4fa0: 6d 73 65 74 28 26 70 56 64 62 65 46 75 6e 63 2d mset(&pVdbeFunc-
4fb0: 3e 61 70 41 75 78 5b 6e 41 75 78 5d 2c 20 30 2c >apAux[nAux], 0,
4fc0: 20 73 69 7a 65 6f 66 28 73 74 72 75 63 74 20 41 sizeof(struct A
4fd0: 75 78 44 61 74 61 29 2a 28 69 41 72 67 2b 31 2d uxData)*(iArg+1-
4fe0: 6e 41 75 78 29 29 3b 0a 20 20 20 20 70 56 64 62 nAux));. pVdb
4ff0: 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d 20 69 41 eFunc->nAux = iA
5000: 72 67 2b 31 3b 0a 20 20 20 20 70 56 64 62 65 46 rg+1;. pVdbeF
5010: 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20 70 43 74 unc->pFunc = pCt
5020: 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d 0a 0a 20 x->pFunc;. }..
5030: 20 70 41 75 78 44 61 74 61 20 3d 20 26 70 56 64 pAuxData = &pVd
5040: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 41 beFunc->apAux[iA
5050: 72 67 5d 3b 0a 20 20 69 66 28 20 70 41 75 78 44 rg];. if( pAuxD
5060: 61 74 61 2d 3e 70 41 75 78 20 26 26 20 70 41 75 ata->pAux && pAu
5070: 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 20 29 xData->xDelete )
5080: 7b 0a 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e {. pAuxData->
5090: 78 44 65 6c 65 74 65 28 70 41 75 78 44 61 74 61 xDelete(pAuxData
50a0: 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20 20 70 ->pAux);. }. p
50b0: 41 75 78 44 61 74 61 2d 3e 70 41 75 78 20 3d 20 AuxData->pAux =
50c0: 70 41 75 78 3b 0a 20 20 70 41 75 78 44 61 74 61 pAux;. pAuxData
50d0: 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78 44 65 6c ->xDelete = xDel
50e0: 65 74 65 3b 0a 20 20 72 65 74 75 72 6e 3b 0a 0a ete;. return;..
50f0: 66 61 69 6c 65 64 3a 0a 20 20 69 66 28 20 78 44 failed:. if( xD
5100: 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 78 44 65 elete ){. xDe
5110: 6c 65 74 65 28 70 41 75 78 29 3b 0a 20 20 7d 0a lete(pAux);. }.
5120: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
5130: 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 E_OMIT_DEPRECATE
5140: 44 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 D./*.** Return t
5150: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d he number of tim
5160: 65 73 20 74 68 65 20 53 74 65 70 20 66 75 6e 63 es the Step func
5170: 74 69 6f 6e 20 6f 66 20 61 20 61 67 67 72 65 67 tion of a aggreg
5180: 61 74 65 20 68 61 73 20 62 65 65 6e 20 0a 2a 2a ate has been .**
5190: 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 called..**.** T
51a0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
51b0: 64 65 70 72 65 63 61 74 65 64 2e 20 20 44 6f 20 deprecated. Do
51c0: 6e 6f 74 20 75 73 65 20 69 74 20 66 6f 72 20 6e not use it for n
51d0: 65 77 20 63 6f 64 65 2e 20 20 49 74 20 69 73 0a ew code. It is.
51e0: 2a 2a 20 70 72 6f 76 69 64 65 20 6f 6e 6c 79 20 ** provide only
51f0: 74 6f 20 61 76 6f 69 64 20 62 72 65 61 6b 69 6e to avoid breakin
5200: 67 20 6c 65 67 61 63 79 20 63 6f 64 65 2e 20 20 g legacy code.
5210: 4e 65 77 20 61 67 67 72 65 67 61 74 65 20 66 75 New aggregate fu
5220: 6e 63 74 69 6f 6e 0a 2a 2a 20 69 6d 70 6c 65 6d nction.** implem
5230: 65 6e 74 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 entations should
5240: 20 6b 65 65 70 20 74 68 65 69 72 20 6f 77 6e 20 keep their own
5250: 63 6f 75 6e 74 73 20 77 69 74 68 69 6e 20 74 68 counts within th
5260: 65 69 72 20 61 67 67 72 65 67 61 74 65 0a 2a 2a eir aggregate.**
5270: 20 63 6f 6e 74 65 78 74 2e 0a 2a 2f 0a 69 6e 74 context..*/.int
5280: 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 sqlite3_aggrega
5290: 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 te_count(sqlite3
52a0: 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 _context *p){.
52b0: 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e assert( p && p->
52c0: 70 4d 65 6d 20 26 26 20 70 2d 3e 70 46 75 6e 63 pMem && p->pFunc
52d0: 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 53 && p->pFunc->xS
52e0: 74 65 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 tep );. return
52f0: 70 2d 3e 70 4d 65 6d 2d 3e 6e 3b 0a 7d 0a 23 65 p->pMem->n;.}.#e
5300: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ndif../*.** Retu
5310: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
5320: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the
5330: 72 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74 result set for t
5340: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 he statement pSt
5350: 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 mt..*/.int sqlit
5360: 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 e3_column_count(
5370: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
5380: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 tmt){. Vdbe *pV
5390: 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d m = (Vdbe *)pStm
53a0: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20 t;. return pVm
53b0: 3f 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d ? pVm->nResColum
53c0: 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n : 0;.}../*.**
53d0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
53e0: 72 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 r of values avai
53f0: 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 lable from the c
5400: 75 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 urrent row of th
5410: 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 e.** currently e
5420: 78 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 xecuting stateme
5430: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 nt pStmt..*/.int
5440: 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f sqlite3_data_co
5450: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 unt(sqlite3_stmt
5460: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 *pStmt){. Vdbe
5470: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 *pVm = (Vdbe *)
5480: 70 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d pStmt;. if( pVm
5490: 3d 3d 30 20 7c 7c 20 70 56 6d 2d 3e 70 52 65 73 ==0 || pVm->pRes
54a0: 75 6c 74 53 65 74 3d 3d 30 20 29 20 72 65 74 75 ultSet==0 ) retu
54b0: 72 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 rn 0;. return p
54c0: 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a Vm->nResColumn;.
54d0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 }.../*.** Check
54e0: 74 6f 20 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e to see if column
54f0: 20 69 43 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 iCol of the giv
5500: 65 6e 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 en statement is
5510: 76 61 6c 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 valid. If.** it
5520: 20 69 73 2c 20 72 65 74 75 72 6e 20 61 20 70 6f is, return a po
5530: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d inter to the Mem
5540: 20 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f for the value o
5550: 66 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a f that column..*
5560: 2a 20 49 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 * If iCol is not
5570: 20 76 61 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 valid, return a
5580: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 pointer to a Me
5590: 6d 20 77 68 69 63 68 20 68 61 73 20 61 20 76 61 m which has a va
55a0: 6c 75 65 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a lue.** of NULL..
55b0: 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 */.static Mem *c
55c0: 6f 6c 75 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 olumnMem(sqlite3
55d0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e _stmt *pStmt, in
55e0: 74 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 t i){. Vdbe *pV
55f0: 6d 3b 0a 20 20 69 6e 74 20 76 61 6c 73 3b 0a 20 m;. int vals;.
5600: 20 4d 65 6d 20 2a 70 4f 75 74 3b 0a 0a 20 20 70 Mem *pOut;.. p
5610: 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 Vm = (Vdbe *)pSt
5620: 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 20 26 26 mt;. if( pVm &&
5630: 20 70 56 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 pVm->pResultSet
5640: 21 3d 30 20 26 26 20 69 3c 70 56 6d 2d 3e 6e 52 !=0 && i<pVm->nR
5650: 65 73 43 6f 6c 75 6d 6e 20 26 26 20 69 3e 3d 30 esColumn && i>=0
5660: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ){. sqlite3_
5670: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 56 6d 2d mutex_enter(pVm-
5680: 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 >db->mutex);.
5690: 20 76 61 6c 73 20 3d 20 73 71 6c 69 74 65 33 5f vals = sqlite3_
56a0: 64 61 74 61 5f 63 6f 75 6e 74 28 70 53 74 6d 74 data_count(pStmt
56b0: 29 3b 0a 20 20 20 20 70 4f 75 74 20 3d 20 26 70 );. pOut = &p
56c0: 56 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 5b 69 Vm->pResultSet[i
56d0: 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 ];. }else{.
56e0: 2f 2a 20 28 28 64 6f 75 62 6c 65 29 30 29 20 49 /* ((double)0) I
56f0: 6e 20 63 61 73 65 20 6f 66 20 53 51 4c 49 54 45 n case of SQLITE
5700: 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 _OMIT_FLOATING_P
5710: 4f 49 4e 54 2e 2e 2e 20 2a 2f 0a 20 20 20 20 73 OINT... */. s
5720: 74 61 74 69 63 20 63 6f 6e 73 74 20 4d 65 6d 20 tatic const Mem
5730: 6e 75 6c 6c 4d 65 6d 20 3d 20 7b 7b 30 7d 2c 20 nullMem = {{0},
5740: 28 64 6f 75 62 6c 65 29 30 2c 20 30 2c 20 22 22 (double)0, 0, ""
5750: 2c 20 30 2c 20 4d 45 4d 5f 4e 75 6c 6c 2c 20 53 , 0, MEM_Null, S
5760: 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 30 2c 20 30 QLITE_NULL, 0, 0
5770: 2c 20 30 20 7d 3b 0a 20 20 20 20 69 66 28 20 70 , 0 };. if( p
5780: 56 6d 20 26 26 20 70 56 6d 2d 3e 64 62 20 29 7b Vm && pVm->db ){
5790: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
57a0: 75 74 65 78 5f 65 6e 74 65 72 28 70 56 6d 2d 3e utex_enter(pVm->
57b0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 db->mutex);.
57c0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 sqlite3Error(p
57d0: 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 Vm->db, SQLITE_R
57e0: 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 7d 0a ANGE, 0);. }.
57f0: 20 20 20 20 70 4f 75 74 20 3d 20 28 4d 65 6d 2a pOut = (Mem*
5800: 29 26 6e 75 6c 6c 4d 65 6d 3b 0a 20 20 7d 0a 20 )&nullMem;. }.
5810: 20 72 65 74 75 72 6e 20 70 4f 75 74 3b 0a 7d 0a return pOut;.}.
5820: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
5830: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 tion is called a
5840: 66 74 65 72 20 69 6e 76 6f 6b 69 6e 67 20 61 6e fter invoking an
5850: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 58 sqlite3_value_X
5860: 58 58 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 61 XX function on a
5870: 20 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 .** column valu
5880: 65 20 28 69 2e 65 2e 20 61 20 76 61 6c 75 65 20 e (i.e. a value
5890: 72 65 74 75 72 6e 65 64 20 62 79 20 65 76 61 6c returned by eval
58a0: 75 61 74 69 6e 67 20 61 6e 20 53 51 4c 20 65 78 uating an SQL ex
58b0: 70 72 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 0a pression in the.
58c0: 2a 2a 20 73 65 6c 65 63 74 20 6c 69 73 74 20 6f ** select list o
58d0: 66 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 f a SELECT state
58e0: 6d 65 6e 74 29 20 74 68 61 74 20 6d 61 79 20 63 ment) that may c
58f0: 61 75 73 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 ause a malloc()
5900: 66 61 69 6c 75 72 65 2e 20 49 66 20 0a 2a 2a 20 failure. If .**
5910: 6d 61 6c 6c 6f 63 28 29 20 68 61 73 20 66 61 69 malloc() has fai
5920: 6c 65 64 2c 20 74 68 65 20 74 68 72 65 61 64 73 led, the threads
5930: 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c mallocFailed fl
5940: 61 67 20 69 73 20 63 6c 65 61 72 65 64 20 61 6e ag is cleared an
5950: 64 20 74 68 65 20 72 65 73 75 6c 74 0a 2a 2a 20 d the result.**
5960: 63 6f 64 65 20 6f 66 20 73 74 61 74 65 6d 65 6e code of statemen
5970: 74 20 70 53 74 6d 74 20 73 65 74 20 74 6f 20 53 t pStmt set to S
5980: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2a 0a QLITE_NOMEM..**.
5990: 2a 2a 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c ** Specifically,
59a0: 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 this is called
59b0: 66 72 6f 6d 20 77 69 74 68 69 6e 3a 0a 2a 2a 0a from within:.**.
59c0: 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 ** sqlite3_c
59d0: 6f 6c 75 6d 6e 5f 69 6e 74 28 29 0a 2a 2a 20 20 olumn_int().**
59e0: 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d sqlite3_colum
59f0: 6e 5f 69 6e 74 36 34 28 29 0a 2a 2a 20 20 20 20 n_int64().**
5a00: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
5a10: 74 65 78 74 28 29 0a 2a 2a 20 20 20 20 20 73 71 text().** sq
5a20: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 lite3_column_tex
5a30: 74 31 36 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c t16().** sql
5a40: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 72 65 61 6c ite3_column_real
5a50: 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 ().** sqlite
5a60: 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 29 3_column_bytes()
5a70: 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f .** sqlite3_
5a80: 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36 28 29 column_bytes16()
5a90: 0a 2a 2a 0a 2a 2a 20 42 75 74 20 6e 6f 74 20 66 .**.** But not f
5aa0: 6f 72 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d or sqlite3_colum
5ab0: 6e 5f 62 6c 6f 62 28 29 2c 20 77 68 69 63 68 20 n_blob(), which
5ac0: 6e 65 76 65 72 20 63 61 6c 6c 73 20 6d 61 6c 6c never calls mall
5ad0: 6f 63 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 oc()..*/.static
5ae0: 76 6f 69 64 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f void columnMallo
5af0: 63 46 61 69 6c 75 72 65 28 73 71 6c 69 74 65 33 cFailure(sqlite3
5b00: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 0a 7b 0a _stmt *pStmt).{.
5b10: 20 20 2f 2a 20 49 66 20 6d 61 6c 6c 6f 63 28 29 /* If malloc()
5b20: 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 61 failed during a
5b30: 6e 20 65 6e 63 6f 64 69 6e 67 20 63 6f 6e 76 65 n encoding conve
5b40: 72 73 69 6f 6e 20 77 69 74 68 69 6e 20 61 6e 0a rsion within an.
5b50: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c ** sqlite3_col
5b60: 75 6d 6e 5f 58 58 58 20 41 50 49 2c 20 74 68 65 umn_XXX API, the
5b70: 6e 20 73 65 74 20 74 68 65 20 72 65 74 75 72 6e n set the return
5b80: 20 63 6f 64 65 20 6f 66 20 74 68 65 20 73 74 61 code of the sta
5b90: 74 65 6d 65 6e 74 20 74 6f 0a 20 20 2a 2a 20 53 tement to. ** S
5ba0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 20 54 68 65 QLITE_NOMEM. The
5bb0: 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f 20 5f 73 next call to _s
5bc0: 74 65 70 28 29 20 28 69 66 20 61 6e 79 29 20 77 tep() (if any) w
5bd0: 69 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ill return SQLIT
5be0: 45 5f 45 52 52 4f 52 0a 20 20 2a 2a 20 61 6e 64 E_ERROR. ** and
5bf0: 20 5f 66 69 6e 61 6c 69 7a 65 28 29 20 77 69 6c _finalize() wil
5c00: 6c 20 72 65 74 75 72 6e 20 4e 4f 4d 45 4d 2e 0a l return NOMEM..
5c10: 20 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 20 3d */. Vdbe *p =
5c20: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a (Vdbe *)pStmt;.
5c30: 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 70 if( p ){. p
5c40: 2d 3e 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 ->rc = sqlite3Ap
5c50: 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 70 2d 3e iExit(p->db, p->
5c60: 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 rc);. sqlite3
5c70: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e _mutex_leave(p->
5c80: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a db->mutex);. }.
5c90: 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a }../************
5ca0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5cb0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
5cc0: 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************
5cd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
5ce0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
5cf0: 6e 67 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 ng routines are
5d00: 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 65 used to access e
5d10: 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 63 lements of the c
5d20: 75 72 72 65 6e 74 20 72 6f 77 0a 2a 2a 20 69 6e urrent row.** in
5d30: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e the result set.
5d40: 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a .*/.const void *
5d50: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 sqlite3_column_b
5d60: 6c 6f 62 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 lob(sqlite3_stmt
5d70: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b *pStmt, int i){
5d80: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 76 . const void *v
5d90: 61 6c 3b 0a 20 20 76 61 6c 20 3d 20 73 71 6c 69 al;. val = sqli
5da0: 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 20 te3_value_blob(
5db0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c columnMem(pStmt,
5dc0: 69 29 20 29 3b 0a 20 20 2f 2a 20 45 76 65 6e 20 i) );. /* Even
5dd0: 74 68 6f 75 67 68 20 74 68 65 72 65 20 69 73 20 though there is
5de0: 6e 6f 20 65 6e 63 6f 64 69 6e 67 20 63 6f 6e 76 no encoding conv
5df0: 65 72 73 69 6f 6e 2c 20 76 61 6c 75 65 5f 62 6c ersion, value_bl
5e00: 6f 62 28 29 20 6d 69 67 68 74 0a 20 20 2a 2a 20 ob() might. **
5e10: 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 6d 61 6c need to call mal
5e20: 6c 6f 63 28 29 20 74 6f 20 65 78 70 61 6e 64 20 loc() to expand
5e30: 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 61 20 the result of a
5e40: 7a 65 72 6f 62 6c 6f 62 28 29 20 0a 20 20 2a 2a zeroblob() . **
5e50: 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 0a 20 20 expression. .
5e60: 2a 2f 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f */. columnMallo
5e70: 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b cFailure(pStmt);
5e80: 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d . return val;.}
5e90: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c .int sqlite3_col
5ea0: 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c 69 74 65 umn_bytes(sqlite
5eb0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
5ec0: 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c nt i){. int val
5ed0: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 = sqlite3_value
5ee0: 5f 62 79 74 65 73 28 20 63 6f 6c 75 6d 6e 4d 65 _bytes( columnMe
5ef0: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 m(pStmt,i) );.
5f00: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c columnMallocFail
5f10: 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 ure(pStmt);. re
5f20: 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 turn val;.}.int
5f30: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 sqlite3_column_b
5f40: 79 74 65 73 31 36 28 73 71 6c 69 74 65 33 5f 73 ytes16(sqlite3_s
5f50: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
5f60: 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 i){. int val =
5f70: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 sqlite3_value_by
5f80: 74 65 73 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d tes16( columnMem
5f90: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 (pStmt,i) );. c
5fa0: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 olumnMallocFailu
5fb0: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 re(pStmt);. ret
5fc0: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 64 6f 75 62 6c urn val;.}.doubl
5fd0: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e e sqlite3_column
5fe0: 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f _double(sqlite3_
5ff0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 stmt *pStmt, int
6000: 20 69 29 7b 0a 20 20 64 6f 75 62 6c 65 20 76 61 i){. double va
6010: 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 l = sqlite3_valu
6020: 65 5f 64 6f 75 62 6c 65 28 20 63 6f 6c 75 6d 6e e_double( column
6030: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a Mem(pStmt,i) );.
6040: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 columnMallocFa
6050: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 ilure(pStmt);.
6060: 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e return val;.}.in
6070: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e t sqlite3_column
6080: 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d _int(sqlite3_stm
6090: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 t *pStmt, int i)
60a0: 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 {. int val = sq
60b0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 lite3_value_int(
60c0: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 columnMem(pStmt
60d0: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d ,i) );. columnM
60e0: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 allocFailure(pSt
60f0: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 mt);. return va
6100: 6c 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 l;.}.sqlite_int6
6110: 34 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 4 sqlite3_column
6120: 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 73 _int64(sqlite3_s
6130: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
6140: 69 29 7b 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 i){. sqlite_int
6150: 36 34 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 64 val = sqlite3
6160: 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 20 63 6f _value_int64( co
6170: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 lumnMem(pStmt,i)
6180: 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c );. columnMall
6190: 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 ocFailure(pStmt)
61a0: 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a ;. return val;.
61b0: 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 }.const unsigned
61c0: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 char *sqlite3_c
61d0: 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71 6c 69 74 olumn_text(sqlit
61e0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
61f0: 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e 73 74 20 int i){. const
6200: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 76 unsigned char *v
6210: 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c al = sqlite3_val
6220: 75 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e 4d ue_text( columnM
6230: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 em(pStmt,i) );.
6240: 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 columnMallocFai
6250: 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 lure(pStmt);. r
6260: 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 73 71 6c eturn val;.}.sql
6270: 69 74 65 33 5f 76 61 6c 75 65 20 2a 73 71 6c 69 ite3_value *sqli
6280: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 te3_column_value
6290: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
62a0: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 Stmt, int i){.
62b0: 4d 65 6d 20 2a 70 4f 75 74 20 3d 20 63 6f 6c 75 Mem *pOut = colu
62c0: 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 20 69 29 3b mnMem(pStmt, i);
62d0: 0a 20 20 69 66 28 20 70 4f 75 74 2d 3e 66 6c 61 . if( pOut->fla
62e0: 67 73 26 4d 45 4d 5f 53 74 61 74 69 63 20 29 7b gs&MEM_Static ){
62f0: 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 . pOut->flags
6300: 20 26 3d 20 7e 4d 45 4d 5f 53 74 61 74 69 63 3b &= ~MEM_Static;
6310: 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 . pOut->flags
6320: 20 7c 3d 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 |= MEM_Ephem;.
6330: 20 7d 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f }. columnMallo
6340: 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b cFailure(pStmt);
6350: 0a 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 . return (sqlit
6360: 65 33 5f 76 61 6c 75 65 20 2a 29 70 4f 75 74 3b e3_value *)pOut;
6370: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 .}.#ifndef SQLIT
6380: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e E_OMIT_UTF16.con
6390: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 st void *sqlite3
63a0: 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 _column_text16(s
63b0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
63c0: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f mt, int i){. co
63d0: 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c 20 3d 20 nst void *val =
63e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 sqlite3_value_te
63f0: 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 xt16( columnMem(
6400: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f pStmt,i) );. co
6410: 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 lumnMallocFailur
6420: 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 e(pStmt);. retu
6430: 72 6e 20 76 61 6c 3b 0a 7d 0a 23 65 6e 64 69 66 rn val;.}.#endif
6440: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
6450: 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c UTF16 */.int sql
6460: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 ite3_column_type
6470: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
6480: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 Stmt, int i){.
6490: 69 6e 74 20 69 54 79 70 65 20 3d 20 73 71 6c 69 int iType = sqli
64a0: 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 20 te3_value_type(
64b0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c columnMem(pStmt,
64c0: 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 i) );. columnMa
64d0: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d llocFailure(pStm
64e0: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 69 54 79 t);. return iTy
64f0: 70 65 3b 0a 7d 0a 0a 2f 2a 20 54 68 65 20 66 6f pe;.}../* The fo
6500: 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 6f 6e llowing function
6510: 20 69 73 20 65 78 70 65 72 69 6d 65 6e 74 61 6c is experimental
6520: 20 61 6e 64 20 73 75 62 6a 65 63 74 20 74 6f 20 and subject to
6530: 63 68 61 6e 67 65 20 6f 72 0a 2a 2a 20 72 65 6d change or.** rem
6540: 6f 76 61 6c 20 2a 2f 0a 2f 2a 69 6e 74 20 73 71 oval */./*int sq
6550: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 75 6d lite3_column_num
6560: 65 72 69 63 5f 74 79 70 65 28 73 71 6c 69 74 65 eric_type(sqlite
6570: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
6580: 6e 74 20 69 29 7b 0a 2a 2a 20 20 72 65 74 75 72 nt i){.** retur
6590: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f n sqlite3_value_
65a0: 6e 75 6d 65 72 69 63 5f 74 79 70 65 28 20 63 6f numeric_type( co
65b0: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 lumnMem(pStmt,i)
65c0: 20 29 3b 0a 2a 2a 7d 0a 2a 2f 0a 0a 2f 2a 0a 2a );.**}.*/../*.*
65d0: 2a 20 43 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d * Convert the N-
65e0: 74 68 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 th element of pS
65f0: 74 6d 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 tmt->pColName[]
6600: 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 75 73 into a string us
6610: 69 6e 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 ing.** xFunc() t
6620: 68 65 6e 20 72 65 74 75 72 6e 20 74 68 61 74 20 hen return that
6630: 73 74 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 string. If N is
6640: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 out of range, r
6650: 65 74 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 eturn 0..**.** T
6660: 68 65 72 65 20 61 72 65 20 75 70 20 74 6f 20 35 here are up to 5
6670: 20 6e 61 6d 65 73 20 66 6f 72 20 65 61 63 68 20 names for each
6680: 63 6f 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 column. useType
6690: 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 69 63 determines whic
66a0: 68 0a 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 h.** name is ret
66b0: 75 72 6e 65 64 2e 20 20 48 65 72 65 20 61 72 65 urned. Here are
66c0: 20 74 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a the names:.**.*
66d0: 2a 20 20 20 20 30 20 20 20 20 20 20 54 68 65 20 * 0 The
66e0: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 column name as i
66f0: 74 20 73 68 6f 75 6c 64 20 62 65 20 64 69 73 70 t should be disp
6700: 6c 61 79 65 64 20 66 6f 72 20 6f 75 74 70 75 74 layed for output
6710: 0a 2a 2a 20 20 20 20 31 20 20 20 20 20 20 54 68 .** 1 Th
6720: 65 20 64 61 74 61 74 79 70 65 20 6e 61 6d 65 20 e datatype name
6730: 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a for the column.*
6740: 2a 20 20 20 20 32 20 20 20 20 20 20 54 68 65 20 * 2 The
6750: 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 name of the data
6760: 62 61 73 65 20 74 68 61 74 20 74 68 65 20 63 6f base that the co
6770: 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f lumn derives fro
6780: 6d 0a 2a 2a 20 20 20 20 33 20 20 20 20 20 20 54 m.** 3 T
6790: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 he name of the t
67a0: 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 63 6f able that the co
67b0: 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f lumn derives fro
67c0: 6d 0a 2a 2a 20 20 20 20 34 20 20 20 20 20 20 54 m.** 4 T
67d0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 he name of the t
67e0: 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 able column that
67f0: 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 the result colu
6800: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a mn derives from.
6810: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 73 **.** If the res
6820: 75 6c 74 20 69 73 20 6e 6f 74 20 61 20 73 69 6d ult is not a sim
6830: 70 6c 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 ple column refer
6840: 65 6e 63 65 20 28 69 66 20 69 74 20 69 73 20 61 ence (if it is a
6850: 6e 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 n expression.**
6860: 6f 72 20 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 or a constant) t
6870: 68 65 6e 20 75 73 65 54 79 70 65 73 20 32 2c 20 hen useTypes 2,
6880: 33 2c 20 61 6e 64 20 34 20 72 65 74 75 72 6e 20 3, and 4 return
6890: 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 NULL..*/.static
68a0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 const void *colu
68b0: 6d 6e 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 mnName(. sqlite
68c0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 3_stmt *pStmt,.
68d0: 20 69 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74 20 int N,. const
68e0: 76 6f 69 64 20 2a 28 2a 78 46 75 6e 63 29 28 4d void *(*xFunc)(M
68f0: 65 6d 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65 54 em*),. int useT
6900: 79 70 65 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 76 ype.){. const v
6910: 6f 69 64 20 2a 72 65 74 20 3d 20 30 3b 0a 20 20 oid *ret = 0;.
6920: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 Vdbe *p = (Vdbe
6930: 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 6e *)pStmt;. int n
6940: 3b 0a 20 20 0a 0a 20 20 69 66 28 20 70 21 3d 30 ;. .. if( p!=0
6950: 20 29 7b 0a 20 20 20 20 6e 20 3d 20 73 71 6c 69 ){. n = sqli
6960: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 te3_column_count
6970: 28 70 53 74 6d 74 29 3b 0a 20 20 20 20 69 66 28 (pStmt);. if(
6980: 20 4e 3c 6e 20 26 26 20 4e 3e 3d 30 20 29 7b 0a N<n && N>=0 ){.
6990: 20 20 20 20 20 20 4e 20 2b 3d 20 75 73 65 54 79 N += useTy
69a0: 70 65 2a 6e 3b 0a 20 20 20 20 20 20 73 71 6c 69 pe*n;. sqli
69b0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
69c0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 p->db->mutex);.
69d0: 20 20 20 20 20 72 65 74 20 3d 20 78 46 75 6e 63 ret = xFunc
69e0: 28 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d (&p->aColName[N]
69f0: 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 41 20 6d );.. /* A m
6a00: 61 6c 6c 6f 63 20 6d 61 79 20 68 61 76 65 20 66 alloc may have f
6a10: 61 69 6c 65 64 20 69 6e 73 69 64 65 20 6f 66 20 ailed inside of
6a20: 74 68 65 20 78 46 75 6e 63 28 29 20 63 61 6c 6c the xFunc() call
6a30: 2e 20 49 66 20 74 68 69 73 0a 20 20 20 20 20 20 . If this.
6a40: 2a 2a 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 ** is the case,
6a50: 63 6c 65 61 72 20 74 68 65 20 6d 61 6c 6c 6f 63 clear the malloc
6a60: 46 61 69 6c 65 64 20 66 6c 61 67 20 61 6e 64 20 Failed flag and
6a70: 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 20 20 20 return NULL..
6a80: 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
6a90: 70 2d 3e 64 62 20 26 26 20 70 2d 3e 64 62 2d 3e p->db && p->db->
6aa0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
6ab0: 20 20 20 20 20 20 20 20 70 2d 3e 64 62 2d 3e 6d p->db->m
6ac0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30 3b allocFailed = 0;
6ad0: 0a 20 20 20 20 20 20 20 20 72 65 74 20 3d 20 30 . ret = 0
6ae0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
6af0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
6b00: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 ave(p->db->mutex
6b10: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 );. }. }. r
6b20: 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a eturn ret;.}../*
6b30: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
6b40: 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68 20 63 ame of the Nth c
6b50: 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 olumn of the res
6b60: 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e 65 64 ult set returned
6b70: 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65 by SQL.** state
6b80: 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63 ment pStmt..*/.c
6b90: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
6ba0: 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73 e3_column_name(s
6bb0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
6bc0: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 mt, int N){. re
6bd0: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 turn columnName(
6be0: 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c . pStmt, N,
6bf0: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 (const void*(*)
6c00: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 (Mem*))sqlite3_v
6c10: 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 alue_text, COLNA
6c20: 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 69 66 6e ME_NAME);.}.#ifn
6c30: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
6c40: 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 UTF16.const void
6c50: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e *sqlite3_column
6c60: 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f _name16(sqlite3_
6c70: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 stmt *pStmt, int
6c80: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f N){. return co
6c90: 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 lumnName(.
6ca0: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 pStmt, N, (const
6cb0: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 void*(*)(Mem*))
6cc0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 sqlite3_value_te
6cd0: 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 xt16, COLNAME_NA
6ce0: 4d 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f ME);.}.#endif../
6cf0: 2a 0a 2a 2a 20 43 6f 6e 73 74 72 61 69 6e 74 3a *.** Constraint:
6d00: 20 20 49 66 20 79 6f 75 20 68 61 76 65 20 45 4e If you have EN
6d10: 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 ABLE_COLUMN_META
6d20: 44 41 54 41 20 74 68 65 6e 20 79 6f 75 20 6d 75 DATA then you mu
6d30: 73 74 0a 2a 2a 20 6e 6f 74 20 64 65 66 69 6e 65 st.** not define
6d40: 20 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45 2e 0a OMIT_DECLTYPE..
6d50: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
6d60: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 QLITE_OMIT_DECLT
6d70: 59 50 45 29 20 26 26 20 64 65 66 69 6e 65 64 28 YPE) && defined(
6d80: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f SQLITE_ENABLE_CO
6d90: 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 29 0a 23 LUMN_METADATA).#
6da0: 20 65 72 72 6f 72 20 22 4d 75 73 74 20 6e 6f 74 error "Must not
6db0: 20 64 65 66 69 6e 65 20 62 6f 74 68 20 53 51 4c define both SQL
6dc0: 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 59 50 ITE_OMIT_DECLTYP
6dd0: 45 20 5c 0a 20 20 20 20 20 20 20 20 20 61 6e 64 E \. and
6de0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 SQLITE_ENABLE_C
6df0: 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 22 0a OLUMN_METADATA".
6e00: 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
6e10: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c SQLITE_OMIT_DECL
6e20: 54 59 50 45 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 TYPE./*.** Retur
6e30: 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63 n the column dec
6e40: 6c 61 72 61 74 69 6f 6e 20 74 79 70 65 20 28 69 laration type (i
6e50: 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 6f 66 f applicable) of
6e60: 20 74 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d the 'i'th colum
6e70: 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75 n.** of the resu
6e80: 6c 74 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74 lt set of SQL st
6e90: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a atement pStmt..*
6ea0: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 /.const char *sq
6eb0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 lite3_column_dec
6ec0: 6c 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74 ltype(sqlite3_st
6ed0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e mt *pStmt, int N
6ee0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 ){. return colu
6ef0: 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 53 mnName(. pS
6f00: 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 tmt, N, (const v
6f10: 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 oid*(*)(Mem*))sq
6f20: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 lite3_value_text
6f30: 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 43 4c 54 59 , COLNAME_DECLTY
6f40: 50 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 PE);.}.#ifndef S
6f50: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
6f60: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c .const void *sql
6f70: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c ite3_column_decl
6f80: 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f 73 type16(sqlite3_s
6f90: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
6fa0: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c N){. return col
6fb0: 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 umnName(. p
6fc0: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 Stmt, N, (const
6fd0: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 void*(*)(Mem*))s
6fe0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
6ff0: 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 43 t16, COLNAME_DEC
7000: 4c 54 59 50 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 LTYPE);.}.#endif
7010: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
7020: 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69 66 20 UTF16 */.#endif
7030: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 /* SQLITE_OMIT_D
7040: 45 43 4c 54 59 50 45 20 2a 2f 0a 0a 23 69 66 64 ECLTYPE */..#ifd
7050: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
7060: 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 _COLUMN_METADATA
7070: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
7080: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 e name of the da
7090: 74 61 62 61 73 65 20 66 72 6f 6d 20 77 68 69 63 tabase from whic
70a0: 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d h a result colum
70b0: 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 n derives..** NU
70c0: 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 LL is returned i
70d0: 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c f the result col
70e0: 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 umn is an expres
70f0: 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74 sion or constant
7100: 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 or.** anything
7110: 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f else which is no
7120: 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20 t an unabiguous
7130: 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64 reference to a d
7140: 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a atabase column..
7150: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
7160: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 qlite3_column_da
7170: 74 61 62 61 73 65 5f 6e 61 6d 65 28 73 71 6c 69 tabase_name(sqli
7180: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
7190: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 int N){. retur
71a0: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 n columnName(.
71b0: 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 pStmt, N, (c
71c0: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 onst void*(*)(Me
71d0: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 m*))sqlite3_valu
71e0: 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f e_text, COLNAME_
71f0: 44 41 54 41 42 41 53 45 29 3b 0a 7d 0a 23 69 66 DATABASE);.}.#if
7200: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
7210: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 _UTF16.const voi
7220: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d d *sqlite3_colum
7230: 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 n_database_name1
7240: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 6(sqlite3_stmt *
7250: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 pStmt, int N){.
7260: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 return columnNa
7270: 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c me(. pStmt,
7280: 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a N, (const void*
7290: 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 (*)(Mem*))sqlite
72a0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 3_value_text16,
72b0: 43 4f 4c 4e 41 4d 45 5f 44 41 54 41 42 41 53 45 COLNAME_DATABASE
72c0: 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 );.}.#endif /* S
72d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
72e0: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 */../*.** Retur
72f0: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 n the name of th
7300: 65 20 74 61 62 6c 65 20 66 72 6f 6d 20 77 68 69 e table from whi
7310: 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 ch a result colu
7320: 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e mn derives..** N
7330: 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 ULL is returned
7340: 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f if the result co
7350: 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 lumn is an expre
7360: 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e ssion or constan
7370: 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 t or.** anything
7380: 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e else which is n
7390: 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 ot an unabiguous
73a0: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 reference to a
73b0: 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e database column.
73c0: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
73d0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 sqlite3_column_t
73e0: 61 62 6c 65 5f 6e 61 6d 65 28 73 71 6c 69 74 65 able_name(sqlite
73f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
7400: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 nt N){. return
7410: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 columnName(.
7420: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e pStmt, N, (con
7430: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a st void*(*)(Mem*
7440: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f ))sqlite3_value_
7450: 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 54 41 text, COLNAME_TA
7460: 42 4c 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 BLE);.}.#ifndef
7470: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
7480: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6.const void *sq
7490: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 lite3_column_tab
74a0: 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 le_name16(sqlite
74b0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
74c0: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 nt N){. return
74d0: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 columnName(.
74e0: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e pStmt, N, (con
74f0: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a st void*(*)(Mem*
7500: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f ))sqlite3_value_
7510: 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f text16, COLNAME_
7520: 54 41 42 4c 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 TABLE);.}.#endif
7530: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
7540: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 UTF16 */../*.**
7550: 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 Return the name
7560: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 63 6f 6c of the table col
7570: 75 6d 6e 20 66 72 6f 6d 20 77 68 69 63 68 20 61 umn from which a
7580: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 result column d
7590: 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 erives..** NULL
75a0: 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 is returned if t
75b0: 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e he result column
75c0: 20 69 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f is an expressio
75d0: 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 n or constant or
75e0: 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 .** anything els
75f0: 65 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 61 e which is not a
7600: 6e 20 75 6e 61 62 69 67 75 6f 75 73 20 72 65 66 n unabiguous ref
7610: 65 72 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 erence to a data
7620: 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a base column..*/.
7630: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 const char *sqli
7640: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 te3_column_origi
7650: 6e 5f 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 n_name(sqlite3_s
7660: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
7670: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c N){. return col
7680: 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 umnName(. p
7690: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 Stmt, N, (const
76a0: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 void*(*)(Mem*))s
76b0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
76c0: 74 2c 20 43 4f 4c 4e 41 4d 45 5f 43 4f 4c 55 4d t, COLNAME_COLUM
76d0: 4e 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 N);.}.#ifndef SQ
76e0: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
76f0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 const void *sqli
7700: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 te3_column_origi
7710: 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 n_name16(sqlite3
7720: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e _stmt *pStmt, in
7730: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 t N){. return c
7740: 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 olumnName(.
7750: 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 pStmt, N, (cons
7760: 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 t void*(*)(Mem*)
7770: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 )sqlite3_value_t
7780: 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 43 ext16, COLNAME_C
7790: 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23 65 6e 64 69 66 OLUMN);.}.#endif
77a0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
77b0: 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69 66 20 UTF16 */.#endif
77c0: 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 /* SQLITE_ENABLE
77d0: 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 _COLUMN_METADATA
77e0: 20 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a */.../*********
77f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7800: 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 62 ****** sqlite3_b
7810: 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ind_ **********
7820: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7830: 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74 69 6e 65 *.** .** Routine
7840: 73 20 75 73 65 64 20 74 6f 20 61 74 74 61 63 68 s used to attach
7850: 20 76 61 6c 75 65 73 20 74 6f 20 77 69 6c 64 63 values to wildc
7860: 61 72 64 73 20 69 6e 20 61 20 63 6f 6d 70 69 6c ards in a compil
7870: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ed SQL statement
7880: 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e 62 69 6e ..*/./*.** Unbin
7890: 64 20 74 68 65 20 76 61 6c 75 65 20 62 6f 75 6e d the value boun
78a0: 64 20 74 6f 20 76 61 72 69 61 62 6c 65 20 69 20 d to variable i
78b0: 69 6e 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 in virtual machi
78c0: 6e 65 20 70 2e 20 54 68 69 73 20 69 73 20 74 68 ne p. This is th
78d0: 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 61 e .** the same a
78e0: 73 20 62 69 6e 64 69 6e 67 20 61 20 4e 55 4c 4c s binding a NULL
78f0: 20 76 61 6c 75 65 20 74 6f 20 74 68 65 20 63 6f value to the co
7900: 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20 22 69 22 lumn. If the "i"
7910: 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a 2a 2a parameter is.**
7920: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 74 out of range, t
7930: 68 65 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 hen SQLITE_RANGE
7940: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
7950: 68 65 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b hewise SQLITE_OK
7960: 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 75 63 63 65 73 ..**.** A succes
7970: 73 66 75 6c 20 65 76 61 6c 75 61 74 69 6f 6e 20 sful evaluation
7980: 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 of this routine
7990: 61 63 71 75 69 72 65 73 20 74 68 65 20 6d 75 74 acquires the mut
79a0: 65 78 20 6f 6e 20 70 2e 0a 2a 2a 20 74 68 65 20 ex on p..** the
79b0: 6d 75 74 65 78 20 69 73 20 72 65 6c 65 61 73 65 mutex is release
79c0: 64 20 69 66 20 61 6e 79 20 6b 69 6e 64 20 6f 66 d if any kind of
79d0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a error occurs..*
79e0: 2a 0a 2a 2a 20 54 68 65 20 65 72 72 6f 72 20 63 *.** The error c
79f0: 6f 64 65 20 73 74 6f 72 65 64 20 69 6e 20 64 61 ode stored in da
7a00: 74 61 62 61 73 65 20 70 2d 3e 64 62 20 69 73 20 tabase p->db is
7a10: 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 74 68 overwritten with
7a20: 20 74 68 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76 the return.** v
7a30: 61 6c 75 65 20 69 6e 20 61 6e 79 20 63 61 73 65 alue in any case
7a40: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
7a50: 76 64 62 65 55 6e 62 69 6e 64 28 56 64 62 65 20 vdbeUnbind(Vdbe
7a60: 2a 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65 *p, int i){. Me
7a70: 6d 20 2a 70 56 61 72 3b 0a 20 20 69 66 28 20 70 m *pVar;. if( p
7a80: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
7a90: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 73 71 ITE_MISUSE;. sq
7aa0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
7ab0: 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b r(p->db->mutex);
7ac0: 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 . if( p->magic!
7ad0: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 =VDBE_MAGIC_RUN
7ae0: 7c 7c 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 || p->pc>=0 ){.
7af0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
7b00: 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 p->db, SQLITE_MI
7b10: 53 55 53 45 2c 20 30 29 3b 0a 20 20 20 20 73 71 SUSE, 0);. sq
7b20: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
7b30: 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b e(p->db->mutex);
7b40: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
7b50: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 TE_MISUSE;. }.
7b60: 20 69 66 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d if( i<1 || i>p-
7b70: 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20 73 71 6c >nVar ){. sql
7b80: 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c ite3Error(p->db,
7b90: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 2c 20 30 SQLITE_RANGE, 0
7ba0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
7bb0: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 utex_leave(p->db
7bc0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65 ->mutex);. re
7bd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 turn SQLITE_RANG
7be0: 45 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20 E;. }. i--;.
7bf0: 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b pVar = &p->aVar[
7c00: 69 5d 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 i];. sqlite3Vdb
7c10: 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 56 61 72 eMemRelease(pVar
7c20: 29 3b 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 73 );. pVar->flags
7c30: 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 = MEM_Null;. s
7c40: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 qlite3Error(p->d
7c50: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 b, SQLITE_OK, 0)
7c60: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
7c70: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 E_OK;.}../*.** B
7c80: 69 6e 64 20 61 20 74 65 78 74 20 6f 72 20 42 4c ind a text or BL
7c90: 4f 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 OB value..*/.sta
7ca0: 74 69 63 20 69 6e 74 20 62 69 6e 64 54 65 78 74 tic int bindText
7cb0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 (. sqlite3_stmt
7cc0: 20 2a 70 53 74 6d 74 2c 20 20 20 2f 2a 20 54 68 *pStmt, /* Th
7cd0: 65 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 62 e statement to b
7ce0: 69 6e 64 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 ind against */.
7cf0: 20 69 6e 74 20 69 2c 20 20 20 20 20 20 20 20 20 int i,
7d00: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 /* Index
7d10: 20 6f 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 of the paramete
7d20: 72 20 74 6f 20 62 69 6e 64 20 2a 2f 0a 20 20 63 r to bind */. c
7d30: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 onst void *zData
7d40: 2c 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 , /* Pointer
7d50: 20 74 6f 20 74 68 65 20 64 61 74 61 20 74 6f 20 to the data to
7d60: 62 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 69 6e be bound */. in
7d70: 74 20 6e 44 61 74 61 2c 20 20 20 20 20 20 20 20 t nData,
7d80: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
7d90: 66 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 f bytes of data
7da0: 74 6f 20 62 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 to be bound */.
7db0: 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f void (*xDel)(vo
7dc0: 69 64 2a 29 2c 20 20 20 2f 2a 20 44 65 73 74 72 id*), /* Destr
7dd0: 75 63 74 6f 72 20 66 6f 72 20 74 68 65 20 64 61 uctor for the da
7de0: 74 61 20 2a 2f 0a 20 20 75 38 20 65 6e 63 6f 64 ta */. u8 encod
7df0: 69 6e 67 20 20 20 20 20 20 20 20 20 20 20 20 2f ing /
7e00: 2a 20 45 6e 63 6f 64 69 6e 67 20 66 6f 72 20 74 * Encoding for t
7e10: 68 65 20 64 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 he data */.){.
7e20: 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 Vdbe *p = (Vdbe
7e30: 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a *)pStmt;. Mem *
7e40: 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a pVar;. int rc;.
7e50: 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 . rc = vdbeUnbi
7e60: 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 nd(p, i);. if(
7e70: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
7e80: 0a 20 20 20 20 69 66 28 20 7a 44 61 74 61 21 3d . if( zData!=
7e90: 30 20 29 7b 0a 20 20 20 20 20 20 70 56 61 72 20 0 ){. pVar
7ea0: 3d 20 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b = &p->aVar[i-1];
7eb0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
7ec0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 te3VdbeMemSetStr
7ed0: 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e 44 (pVar, zData, nD
7ee0: 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67 2c 20 78 ata, encoding, x
7ef0: 44 65 6c 29 3b 0a 20 20 20 20 20 20 69 66 28 20 Del);. if(
7f00: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
7f10: 20 65 6e 63 6f 64 69 6e 67 21 3d 30 20 29 7b 0a encoding!=0 ){.
7f20: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
7f30: 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 45 6e ite3VdbeChangeEn
7f40: 63 6f 64 69 6e 67 28 70 56 61 72 2c 20 45 4e 43 coding(pVar, ENC
7f50: 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20 20 (p->db));.
7f60: 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 }. sqlite3E
7f70: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63 2c 20 rror(p->db, rc,
7f80: 30 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 0);. rc = s
7f90: 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 70 2d qlite3ApiExit(p-
7fa0: 3e 64 62 2c 20 72 63 29 3b 0a 20 20 20 20 7d 0a >db, rc);. }.
7fb0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
7fc0: 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d x_leave(p->db->m
7fd0: 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 utex);. }. ret
7fe0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a urn rc;.}.../*.*
7ff0: 2a 20 42 69 6e 64 20 61 20 62 6c 6f 62 20 76 61 * Bind a blob va
8000: 6c 75 65 20 74 6f 20 61 6e 20 53 51 4c 20 73 74 lue to an SQL st
8010: 61 74 65 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 atement variable
8020: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
8030: 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a 20 20 73 71 _bind_blob(. sq
8040: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
8050: 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 t, . int i, .
8060: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 const void *zDat
8070: 61 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c a, . int nData,
8080: 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 . void (*xDel)
8090: 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 (void*).){. ret
80a0: 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 urn bindText(pSt
80b0: 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 mt, i, zData, nD
80c0: 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 7d ata, xDel, 0);.}
80d0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e .int sqlite3_bin
80e0: 64 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 d_double(sqlite3
80f0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e _stmt *pStmt, in
8100: 74 20 69 2c 20 64 6f 75 62 6c 65 20 72 56 61 6c t i, double rVal
8110: 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ue){. int rc;.
8120: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 Vdbe *p = (Vdbe
8130: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d *)pStmt;. rc =
8140: 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 vdbeUnbind(p, i
8150: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
8160: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 ITE_OK ){. sq
8170: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 44 lite3VdbeMemSetD
8180: 6f 75 62 6c 65 28 26 70 2d 3e 61 56 61 72 5b 69 ouble(&p->aVar[i
8190: 2d 31 5d 2c 20 72 56 61 6c 75 65 29 3b 0a 20 20 -1], rValue);.
81a0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
81b0: 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 leave(p->db->mut
81c0: 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ex);. }. retur
81d0: 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 n rc;.}.int sqli
81e0: 74 65 33 5f 62 69 6e 64 5f 69 6e 74 28 73 71 6c te3_bind_int(sql
81f0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 2c 20 69 6e ite3_stmt *p, in
8200: 74 20 69 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 t i, int iValue)
8210: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 {. return sqlit
8220: 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 28 70 2c e3_bind_int64(p,
8230: 20 69 2c 20 28 69 36 34 29 69 56 61 6c 75 65 29 i, (i64)iValue)
8240: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ;.}.int sqlite3_
8250: 62 69 6e 64 5f 69 6e 74 36 34 28 73 71 6c 69 74 bind_int64(sqlit
8260: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
8270: 69 6e 74 20 69 2c 20 73 71 6c 69 74 65 5f 69 6e int i, sqlite_in
8280: 74 36 34 20 69 56 61 6c 75 65 29 7b 0a 20 20 69 t64 iValue){. i
8290: 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 nt rc;. Vdbe *p
82a0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 = (Vdbe *)pStmt
82b0: 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 ;. rc = vdbeUnb
82c0: 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 ind(p, i);. if(
82d0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
82e0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
82f0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 2d eMemSetInt64(&p-
8300: 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 69 56 61 6c >aVar[i-1], iVal
8310: 75 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ue);. sqlite3
8320: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e _mutex_leave(p->
8330: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a db->mutex);. }.
8340: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 return rc;.}.i
8350: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f nt sqlite3_bind_
8360: 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d null(sqlite3_stm
8370: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 t *pStmt, int i)
8380: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 {. int rc;. Vd
8390: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 be *p = (Vdbe*)p
83a0: 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 Stmt;. rc = vdb
83b0: 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 eUnbind(p, i);.
83c0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
83d0: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 OK ){. sqlite
83e0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3_mutex_leave(p-
83f0: 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d >db->mutex);. }
8400: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
8410: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 int sqlite3_bind
8420: 5f 74 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65 _text( . sqlite
8430: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 3_stmt *pStmt, .
8440: 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 int i, . cons
8450: 74 20 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a t char *zData, .
8460: 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 int nData, .
8470: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 void (*xDel)(voi
8480: 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 d*).){. return
8490: 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 bindText(pStmt,
84a0: 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c i, zData, nData,
84b0: 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54 xDel, SQLITE_UT
84c0: 46 38 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 F8);.}.#ifndef S
84d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
84e0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e .int sqlite3_bin
84f0: 64 5f 74 65 78 74 31 36 28 0a 20 20 73 71 6c 69 d_text16(. sqli
8500: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
8510: 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f . int i, . co
8520: 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c nst void *zData,
8530: 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20 0a . int nData, .
8540: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 void (*xDel)(v
8550: 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 oid*).){. retur
8560: 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 n bindText(pStmt
8570: 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 , i, zData, nDat
8580: 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45 5f a, xDel, SQLITE_
8590: 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a UTF16NATIVE);.}.
85a0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
85b0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 _OMIT_UTF16 */.i
85c0: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f nt sqlite3_bind_
85d0: 76 61 6c 75 65 28 73 71 6c 69 74 65 33 5f 73 74 value(sqlite3_st
85e0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 mt *pStmt, int i
85f0: 2c 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f , const sqlite3_
8600: 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b 0a value *pValue){.
8610: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 int rc;. Vdbe
8620: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 *p = (Vdbe *)pS
8630: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 tmt;. rc = vdbe
8640: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 Unbind(p, i);.
8650: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
8660: 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 K ){. rc = sq
8670: 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 lite3VdbeMemCopy
8680: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 (&p->aVar[i-1],
8690: 70 56 61 6c 75 65 29 3b 0a 20 20 20 20 69 66 28 pValue);. if(
86a0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
86b0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
86c0: 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 45 6e ite3VdbeChangeEn
86d0: 63 6f 64 69 6e 67 28 26 70 2d 3e 61 56 61 72 5b coding(&p->aVar[
86e0: 69 2d 31 5d 2c 20 45 4e 43 28 70 2d 3e 64 62 29 i-1], ENC(p->db)
86f0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c );. }. sql
8700: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
8710: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a (p->db->mutex);.
8720: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
8730: 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62 2c e3ApiExit(p->db,
8740: 20 72 63 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 rc);. return r
8750: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 c;.}.int sqlite3
8760: 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 28 73 _bind_zeroblob(s
8770: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
8780: 6d 74 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 6e mt, int i, int n
8790: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 ){. int rc;. V
87a0: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a dbe *p = (Vdbe *
87b0: 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 )pStmt;. rc = v
87c0: 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b dbeUnbind(p, i);
87d0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
87e0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
87f0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 5a 65 72 te3VdbeMemSetZer
8800: 6f 42 6c 6f 62 28 26 70 2d 3e 61 56 61 72 5b 69 oBlob(&p->aVar[i
8810: 2d 31 5d 2c 20 6e 29 3b 0a 20 20 20 20 73 71 6c -1], n);. sql
8820: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
8830: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a (p->db->mutex);.
8840: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
8850: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
8860: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 77 the number of w
8870: 69 6c 64 63 61 72 64 73 20 74 68 61 74 20 63 61 ildcards that ca
8880: 6e 20 62 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 n be potentially
8890: 20 62 6f 75 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 bound to..** Th
88a0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 64 is routine is ad
88b0: 64 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 44 ded to support D
88c0: 42 44 3a 3a 53 51 4c 69 74 65 2e 20 20 0a 2a 2f BD::SQLite. .*/
88d0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e .int sqlite3_bin
88e0: 64 5f 70 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e d_parameter_coun
88f0: 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a t(sqlite3_stmt *
8900: 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a pStmt){. Vdbe *
8910: 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 p = (Vdbe*)pStmt
8920: 3b 0a 20 20 72 65 74 75 72 6e 20 70 20 3f 20 70 ;. return p ? p
8930: 2d 3e 6e 56 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f ->nVar : 0;.}../
8940: 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6d 61 *.** Create a ma
8950: 70 70 69 6e 67 20 66 72 6f 6d 20 76 61 72 69 61 pping from varia
8960: 62 6c 65 20 6e 75 6d 62 65 72 73 20 74 6f 20 76 ble numbers to v
8970: 61 72 69 61 62 6c 65 20 6e 61 6d 65 73 0a 2a 2a ariable names.**
8980: 20 69 6e 20 74 68 65 20 56 64 62 65 2e 61 7a 56 in the Vdbe.azV
8990: 61 72 5b 5d 20 61 72 72 61 79 2c 20 69 66 20 73 ar[] array, if s
89a0: 75 63 68 20 61 20 6d 61 70 70 69 6e 67 20 64 6f uch a mapping do
89b0: 65 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 0a 2a es not already.*
89c0: 2a 20 65 78 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 * exist..*/.stat
89d0: 69 63 20 76 6f 69 64 20 63 72 65 61 74 65 56 61 ic void createVa
89e0: 72 4d 61 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 rMap(Vdbe *p){.
89f0: 20 69 66 28 20 21 70 2d 3e 6f 6b 56 61 72 20 29 if( !p->okVar )
8a00: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 {. sqlite3_mu
8a10: 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d tex_enter(p->db-
8a20: 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 69 66 28 >mutex);. if(
8a30: 20 21 70 2d 3e 6f 6b 56 61 72 20 29 7b 0a 20 20 !p->okVar ){.
8a40: 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 20 int j;.
8a50: 20 4f 70 20 2a 70 4f 70 3b 0a 20 20 20 20 20 20 Op *pOp;.
8a60: 66 6f 72 28 6a 3d 30 2c 20 70 4f 70 3d 70 2d 3e for(j=0, pOp=p->
8a70: 61 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f 70 3b 20 6a aOp; j<p->nOp; j
8a80: 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20 20 20 ++, pOp++){.
8a90: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 if( pOp->opc
8aa0: 6f 64 65 3d 3d 4f 50 5f 56 61 72 69 61 62 6c 65 ode==OP_Variable
8ab0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 ){. as
8ac0: 73 65 72 74 28 20 70 4f 70 2d 3e 70 31 3e 30 20 sert( pOp->p1>0
8ad0: 26 26 20 70 4f 70 2d 3e 70 31 3c 3d 70 2d 3e 6e && pOp->p1<=p->n
8ae0: 56 61 72 20 29 3b 0a 20 20 20 20 20 20 20 20 20 Var );.
8af0: 20 70 2d 3e 61 7a 56 61 72 5b 70 4f 70 2d 3e 70 p->azVar[pOp->p
8b00: 31 2d 31 5d 20 3d 20 70 4f 70 2d 3e 70 34 2e 7a 1-1] = pOp->p4.z
8b10: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
8b20: 20 20 7d 0a 20 20 20 20 20 20 70 2d 3e 6f 6b 56 }. p->okV
8b30: 61 72 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 ar = 1;. }.
8b40: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
8b50: 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 leave(p->db->mut
8b60: 65 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a ex);. }.}../*.*
8b70: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d * Return the nam
8b80: 65 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64 20 e of a wildcard
8b90: 70 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74 75 parameter. Retu
8ba0: 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 69 rn NULL if the i
8bb0: 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20 6f ndex.** is out o
8bc0: 66 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74 68 f range or if th
8bd0: 65 20 77 69 6c 64 63 61 72 64 20 69 73 20 75 6e e wildcard is un
8be0: 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 named..**.** The
8bf0: 20 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61 79 result is alway
8c00: 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e 73 s UTF-8..*/.cons
8c10: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f t char *sqlite3_
8c20: 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f 6e bind_parameter_n
8c30: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 ame(sqlite3_stmt
8c40: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b *pStmt, int i){
8c50: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 . Vdbe *p = (Vd
8c60: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 be*)pStmt;. if(
8c70: 20 70 3d 3d 30 20 7c 7c 20 69 3c 31 20 7c 7c 20 p==0 || i<1 ||
8c80: 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 i>p->nVar ){.
8c90: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 return 0;. }.
8ca0: 20 63 72 65 61 74 65 56 61 72 4d 61 70 28 70 29 createVarMap(p)
8cb0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 61 7a ;. return p->az
8cc0: 56 61 72 5b 69 2d 31 5d 3b 0a 7d 0a 0a 2f 2a 0a Var[i-1];.}../*.
8cd0: 2a 2a 20 47 69 76 65 6e 20 61 20 77 69 6c 64 63 ** Given a wildc
8ce0: 61 72 64 20 70 61 72 61 6d 65 74 65 72 20 6e 61 ard parameter na
8cf0: 6d 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 69 me, return the i
8d00: 6e 64 65 78 20 6f 66 20 74 68 65 20 76 61 72 69 ndex of the vari
8d10: 61 62 6c 65 0a 2a 2a 20 77 69 74 68 20 74 68 61 able.** with tha
8d20: 74 20 6e 61 6d 65 2e 20 20 49 66 20 74 68 65 72 t name. If ther
8d30: 65 20 69 73 20 6e 6f 20 76 61 72 69 61 62 6c 65 e is no variable
8d40: 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 with the given
8d50: 6e 61 6d 65 2c 0a 2a 2a 20 72 65 74 75 72 6e 20 name,.** return
8d60: 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 0..*/.int sqlite
8d70: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 3_bind_parameter
8d80: 5f 69 6e 64 65 78 28 73 71 6c 69 74 65 33 5f 73 _index(sqlite3_s
8d90: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 63 6f 6e 73 tmt *pStmt, cons
8da0: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a t char *zName){.
8db0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 Vdbe *p = (Vdb
8dc0: 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 6e 74 20 e*)pStmt;. int
8dd0: 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b i;. if( p==0 ){
8de0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
8df0: 20 7d 0a 20 20 63 72 65 61 74 65 56 61 72 4d 61 }. createVarMa
8e00: 70 28 70 29 3b 20 0a 20 20 69 66 28 20 7a 4e 61 p(p); . if( zNa
8e10: 6d 65 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d me ){. for(i=
8e20: 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69 2b 0; i<p->nVar; i+
8e30: 2b 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 +){. const
8e40: 63 68 61 72 20 2a 7a 20 3d 20 70 2d 3e 61 7a 56 char *z = p->azV
8e50: 61 72 5b 69 5d 3b 0a 20 20 20 20 20 20 69 66 28 ar[i];. if(
8e60: 20 7a 20 26 26 20 73 74 72 63 6d 70 28 7a 2c 7a z && strcmp(z,z
8e70: 4e 61 6d 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 Name)==0 ){.
8e80: 20 20 20 20 72 65 74 75 72 6e 20 69 2b 31 3b 0a return i+1;.
8e90: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
8ea0: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a }. return 0;.}.
8eb0: 0a 2f 2a 0a 2a 2a 20 54 72 61 6e 73 66 65 72 20 ./*.** Transfer
8ec0: 61 6c 6c 20 62 69 6e 64 69 6e 67 73 20 66 72 6f all bindings fro
8ed0: 6d 20 74 68 65 20 66 69 72 73 74 20 73 74 61 74 m the first stat
8ee0: 65 6d 65 6e 74 20 6f 76 65 72 20 74 6f 20 74 68 ement over to th
8ef0: 65 20 73 65 63 6f 6e 64 2e 0a 2a 2a 20 49 66 20 e second..** If
8f00: 74 68 65 20 74 77 6f 20 73 74 61 74 65 6d 65 6e the two statemen
8f10: 74 73 20 63 6f 6e 74 61 69 6e 20 61 20 64 69 66 ts contain a dif
8f20: 66 65 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f 66 ferent number of
8f30: 20 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 6e 0a bindings, then.
8f40: 2a 2a 20 61 6e 20 53 51 4c 49 54 45 5f 45 52 52 ** an SQLITE_ERR
8f50: 4f 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a OR is returned..
8f60: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 72 */.int sqlite3Tr
8f70: 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73 28 73 ansferBindings(s
8f80: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 46 72 qlite3_stmt *pFr
8f90: 6f 6d 53 74 6d 74 2c 20 73 71 6c 69 74 65 33 5f omStmt, sqlite3_
8fa0: 73 74 6d 74 20 2a 70 54 6f 53 74 6d 74 29 7b 0a stmt *pToStmt){.
8fb0: 20 20 56 64 62 65 20 2a 70 46 72 6f 6d 20 3d 20 Vdbe *pFrom =
8fc0: 28 56 64 62 65 2a 29 70 46 72 6f 6d 53 74 6d 74 (Vdbe*)pFromStmt
8fd0: 3b 0a 20 20 56 64 62 65 20 2a 70 54 6f 20 3d 20 ;. Vdbe *pTo =
8fe0: 28 56 64 62 65 2a 29 70 54 6f 53 74 6d 74 3b 0a (Vdbe*)pToStmt;.
8ff0: 20 20 69 6e 74 20 69 2c 20 72 63 20 3d 20 53 51 int i, rc = SQ
9000: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 28 LITE_OK;. if( (
9010: 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d 56 44 pFrom->magic!=VD
9020: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 BE_MAGIC_RUN &&
9030: 70 46 72 6f 6d 2d 3e 6d 61 67 69 63 21 3d 56 44 pFrom->magic!=VD
9040: 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 29 0a 20 BE_MAGIC_HALT).
9050: 20 20 20 7c 7c 20 28 70 54 6f 2d 3e 6d 61 67 69 || (pTo->magi
9060: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 c!=VDBE_MAGIC_RU
9070: 4e 20 26 26 20 70 54 6f 2d 3e 6d 61 67 69 63 21 N && pTo->magic!
9080: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 =VDBE_MAGIC_HALT
9090: 29 0a 20 20 20 20 7c 7c 20 70 54 6f 2d 3e 64 62 ). || pTo->db
90a0: 21 3d 70 46 72 6f 6d 2d 3e 64 62 20 29 7b 0a 20 !=pFrom->db ){.
90b0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
90c0: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 _MISUSE;. }. i
90d0: 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61 72 21 3d f( pFrom->nVar!=
90e0: 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 pTo->nVar ){.
90f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 return SQLITE_E
9100: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 RROR;. }. sqli
9110: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
9120: 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b pTo->db->mutex);
9130: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d . for(i=0; rc==
9140: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 70 SQLITE_OK && i<p
9150: 46 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69 2b 2b 29 From->nVar; i++)
9160: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
9170: 65 4d 65 6d 4d 6f 76 65 28 26 70 54 6f 2d 3e 61 eMemMove(&pTo->a
9180: 56 61 72 5b 69 5d 2c 20 26 70 46 72 6f 6d 2d 3e Var[i], &pFrom->
9190: 61 56 61 72 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 aVar[i]);. }.
91a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
91b0: 61 76 65 28 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74 ave(pTo->db->mut
91c0: 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 ex);. assert( r
91d0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
91e0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc==SQLITE_NOMEM
91f0: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
9200: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
9210: 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 TE_OMIT_DEPRECAT
9220: 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72 65 63 61 ED./*.** Depreca
9230: 74 65 64 20 65 78 74 65 72 6e 61 6c 20 69 6e 74 ted external int
9240: 65 72 66 61 63 65 2e 20 20 49 6e 74 65 72 6e 61 erface. Interna
9250: 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65 20 63 6f l/core SQLite co
9260: 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20 63 61 6c de.** should cal
9270: 6c 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66 65 l sqlite3Transfe
9280: 72 42 69 6e 64 69 6e 67 73 2e 0a 2a 2f 0a 69 6e rBindings..*/.in
9290: 74 20 73 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 t sqlite3_transf
92a0: 65 72 5f 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 er_bindings(sqli
92b0: 74 65 33 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53 te3_stmt *pFromS
92c0: 74 6d 74 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d tmt, sqlite3_stm
92d0: 74 20 2a 70 54 6f 53 74 6d 74 29 7b 0a 20 20 72 t *pToStmt){. r
92e0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 54 72 61 eturn sqlite3Tra
92f0: 6e 73 66 65 72 42 69 6e 64 69 6e 67 73 28 70 46 nsferBindings(pF
9300: 72 6f 6d 53 74 6d 74 2c 20 70 54 6f 53 74 6d 74 romStmt, pToStmt
9310: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a );.}.#endif../*.
9320: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 71 ** Return the sq
9330: 6c 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20 lite3* database
9340: 68 61 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20 handle to which
9350: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 the prepared sta
9360: 74 65 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 tement given.**
9370: 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 in the argument
9380: 62 65 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 belongs. This i
9390: 73 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 s the same datab
93a0: 61 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 ase handle that
93b0: 77 61 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 was.** the first
93c0: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 argument to the
93d0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
93e0: 28 29 20 74 68 61 74 20 77 61 73 20 75 73 65 64 () that was used
93f0: 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 to create.** th
9400: 65 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 e statement in t
9410: 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a he first place..
9420: 2a 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 */.sqlite3 *sqli
9430: 74 65 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 te3_db_handle(sq
9440: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
9450: 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 t){. return pSt
9460: 6d 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 mt ? ((Vdbe*)pSt
9470: 6d 74 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a 0a mt)->db : 0;.}..
9480: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 /*.** Return a p
9490: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e 65 ointer to the ne
94a0: 78 74 20 70 72 65 70 61 72 65 64 20 73 74 61 74 xt prepared stat
94b0: 65 6d 65 6e 74 20 61 66 74 65 72 20 70 53 74 6d ement after pStm
94c0: 74 20 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 t associated.**
94d0: 77 69 74 68 20 64 61 74 61 62 61 73 65 20 63 6f with database co
94e0: 6e 6e 65 63 74 69 6f 6e 20 70 44 62 2e 20 20 49 nnection pDb. I
94f0: 66 20 70 53 74 6d 74 20 69 73 20 4e 55 4c 4c 2c f pStmt is NULL,
9500: 20 72 65 74 75 72 6e 20 74 68 65 20 66 69 72 73 return the firs
9510: 74 0a 2a 2a 20 70 72 65 70 61 72 65 64 20 73 74 t.** prepared st
9520: 61 74 65 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 atement for the
9530: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
9540: 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c ion. Return NUL
9550: 4c 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 L if there.** ar
9560: 65 20 6e 6f 20 6d 6f 72 65 2e 0a 2a 2f 0a 73 71 e no more..*/.sq
9570: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 73 71 6c 69 lite3_stmt *sqli
9580: 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74 28 73 71 te3_next_stmt(sq
9590: 6c 69 74 65 33 20 2a 70 44 62 2c 20 73 71 6c 69 lite3 *pDb, sqli
95a0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 te3_stmt *pStmt)
95b0: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 {. sqlite3_stmt
95c0: 20 2a 70 4e 65 78 74 3b 0a 20 20 73 71 6c 69 74 *pNext;. sqlit
95d0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
95e0: 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 Db->mutex);. if
95f0: 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 ( pStmt==0 ){.
9600: 20 20 70 4e 65 78 74 20 3d 20 28 73 71 6c 69 74 pNext = (sqlit
9610: 65 33 5f 73 74 6d 74 2a 29 70 44 62 2d 3e 70 56 e3_stmt*)pDb->pV
9620: 64 62 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 dbe;. }else{.
9630: 20 20 70 4e 65 78 74 20 3d 20 28 73 71 6c 69 74 pNext = (sqlit
9640: 65 33 5f 73 74 6d 74 2a 29 28 28 56 64 62 65 2a e3_stmt*)((Vdbe*
9650: 29 70 53 74 6d 74 29 2d 3e 70 4e 65 78 74 3b 0a )pStmt)->pNext;.
9660: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
9670: 74 65 78 5f 6c 65 61 76 65 28 70 44 62 2d 3e 6d tex_leave(pDb->m
9680: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
9690: 70 4e 65 78 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 pNext;.}../*.**
96a0: 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 Return the value
96b0: 20 6f 66 20 61 20 73 74 61 74 75 73 20 63 6f 75 of a status cou
96c0: 6e 74 65 72 20 66 6f 72 20 61 20 70 72 65 70 61 nter for a prepa
96d0: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2f red statement.*/
96e0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 6d .int sqlite3_stm
96f0: 74 5f 73 74 61 74 75 73 28 73 71 6c 69 74 65 33 t_status(sqlite3
9700: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e _stmt *pStmt, in
9710: 74 20 6f 70 2c 20 69 6e 74 20 72 65 73 65 74 46 t op, int resetF
9720: 6c 61 67 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 lag){. Vdbe *pV
9730: 64 62 65 20 3d 20 28 56 64 62 65 2a 29 70 53 74 dbe = (Vdbe*)pSt
9740: 6d 74 3b 0a 20 20 69 6e 74 20 76 20 3d 20 70 56 mt;. int v = pV
9750: 64 62 65 2d 3e 61 43 6f 75 6e 74 65 72 5b 6f 70 dbe->aCounter[op
9760: 2d 31 5d 3b 0a 20 20 69 66 28 20 72 65 73 65 74 -1];. if( reset
9770: 46 6c 61 67 20 29 20 70 56 64 62 65 2d 3e 61 43 Flag ) pVdbe->aC
9780: 6f 75 6e 74 65 72 5b 6f 70 2d 31 5d 20 3d 20 30 ounter[op-1] = 0
9790: 3b 0a 20 20 72 65 74 75 72 6e 20 76 3b 0a 7d 0a ;. return v;.}.