0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32 /*.** 2004 May 2
0010: 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 6.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 ource code. In
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 **.** May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 evil..** May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 thers..** May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 y, never taking
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 .**.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75 contains code u
0190: 73 65 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 se to implement
01a0: 41 50 49 73 20 74 68 61 74 20 61 72 65 20 70 61 APIs that are pa
01b0: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 56 44 42 rt of the.** VDB
01c0: 45 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 E..*/.#include "
01d0: 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e sqliteInt.h".#in
01e0: 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74 2e 68 clude "vdbeInt.h
01f0: 22 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 "..#ifndef SQLIT
0200: 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 E_OMIT_DEPRECATE
0210: 44 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 D./*.** Return T
0220: 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 6f RUE (non-zero) o
0230: 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 f the statement
0240: 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20 61 supplied as an a
0250: 72 67 75 6d 65 6e 74 20 6e 65 65 64 73 0a 2a 2a rgument needs.**
0260: 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c 65 to be recompile
0270: 64 2e 20 20 41 20 73 74 61 74 65 6d 65 6e 74 20 d. A statement
0280: 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 63 6f needs to be reco
0290: 6d 70 69 6c 65 64 20 77 68 65 6e 65 76 65 72 20 mpiled whenever
02a0: 74 68 65 0a 2a 2a 20 65 78 65 63 75 74 69 6f 6e the.** execution
02b0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 63 68 61 environment cha
02c0: 6e 67 65 73 20 69 6e 20 61 20 77 61 79 20 74 68 nges in a way th
02d0: 61 74 20 77 6f 75 6c 64 20 61 6c 74 65 72 20 74 at would alter t
02e0: 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 74 68 he program.** th
02f0: 61 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 at sqlite3_prepa
0300: 72 65 28 29 20 67 65 6e 65 72 61 74 65 73 2e 20 re() generates.
0310: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 For example, if
0320: 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 73 20 6f new functions o
0330: 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 73 r.** collating s
0340: 65 71 75 65 6e 63 65 73 20 61 72 65 20 72 65 67 equences are reg
0350: 69 73 74 65 72 65 64 20 6f 72 20 69 66 20 61 6e istered or if an
0360: 20 61 75 74 68 6f 72 69 7a 65 72 20 66 75 6e 63 authorizer func
0370: 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64 64 65 64 tion is.** added
0380: 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a or changed..*/.
0390: 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 70 69 int sqlite3_expi
03a0: 72 65 64 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 red(sqlite3_stmt
03b0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 *pStmt){. Vdbe
03c0: 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 *p = (Vdbe*)pSt
03d0: 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 3d 3d mt;. return p==
03e0: 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72 65 64 3b 0 || p->expired;
03f0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
0400: 20 43 68 65 63 6b 20 6f 6e 20 61 20 56 64 62 65 Check on a Vdbe
0410: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 69 74 to make sure it
0420: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 66 69 has not been fi
0430: 6e 61 6c 69 7a 65 64 2e 20 20 4c 6f 67 0a 2a 2a nalized. Log.**
0440: 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 20 72 65 an error and re
0450: 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 turn true if it
0460: 68 61 73 20 62 65 65 6e 20 66 69 6e 61 6c 69 7a has been finaliz
0470: 65 64 20 28 6f 72 20 69 73 20 6f 74 68 65 72 77 ed (or is otherw
0480: 69 73 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 29 2e ise.** invalid).
0490: 20 20 52 65 74 75 72 6e 20 66 61 6c 73 65 20 69 Return false i
04a0: 66 20 69 74 20 69 73 20 6f 6b 2e 0a 2a 2f 0a 73 f it is ok..*/.s
04b0: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 61 tatic int vdbeSa
04c0: 66 65 74 79 28 56 64 62 65 20 2a 70 29 7b 0a 20 fety(Vdbe *p){.
04d0: 20 69 66 28 20 70 2d 3e 64 62 3d 3d 30 20 29 7b if( p->db==0 ){
04e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 . sqlite3_log
04f0: 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 (SQLITE_MISUSE,
0500: 22 41 50 49 20 63 61 6c 6c 65 64 20 77 69 74 68 "API called with
0510: 20 66 69 6e 61 6c 69 7a 65 64 20 70 72 65 70 61 finalized prepa
0520: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 22 29 3b red statement");
0530: 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 . return 1;.
0540: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
0550: 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 rn 0;. }.}.stat
0560: 69 63 20 69 6e 74 20 76 64 62 65 53 61 66 65 74 ic int vdbeSafet
0570: 79 4e 6f 74 4e 75 6c 6c 28 56 64 62 65 20 2a 70 yNotNull(Vdbe *p
0580: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b ){. if( p==0 ){
0590: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 . sqlite3_log
05a0: 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 (SQLITE_MISUSE,
05b0: 22 41 50 49 20 63 61 6c 6c 65 64 20 77 69 74 68 "API called with
05c0: 20 4e 55 4c 4c 20 70 72 65 70 61 72 65 64 20 73 NULL prepared s
05d0: 74 61 74 65 6d 65 6e 74 22 29 3b 0a 20 20 20 20 tatement");.
05e0: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 65 6c 73 return 1;. }els
05f0: 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 76 64 e{. return vd
0600: 62 65 53 61 66 65 74 79 28 70 29 3b 0a 20 20 7d beSafety(p);. }
0610: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
0620: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 2f 2a TE_OMIT_TRACE./*
0630: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 70 .** Invoke the p
0640: 72 6f 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b 2e rofile callback.
0650: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 This routine i
0660: 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 69 66 s only called if
0670: 20 77 65 20 61 6c 72 65 61 64 79 0a 2a 2a 20 6b we already.** k
0680: 6e 6f 77 20 74 68 61 74 20 74 68 65 20 70 72 6f now that the pro
0690: 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b 20 69 73 file callback is
06a0: 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e 65 65 defined and nee
06b0: 64 73 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 ds to be invoked
06c0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 ..*/.static SQLI
06d0: 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 TE_NOINLINE void
06e0: 20 69 6e 76 6f 6b 65 50 72 6f 66 69 6c 65 43 61 invokeProfileCa
06f0: 6c 6c 62 61 63 6b 28 73 71 6c 69 74 65 33 20 2a llback(sqlite3 *
0700: 64 62 2c 20 56 64 62 65 20 2a 70 29 7b 0a 20 20 db, Vdbe *p){.
0710: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4e sqlite3_int64 iN
0720: 6f 77 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e ow;. sqlite3_in
0730: 74 36 34 20 69 45 6c 61 70 73 65 3b 0a 20 20 61 t64 iElapse;. a
0740: 73 73 65 72 74 28 20 70 2d 3e 73 74 61 72 74 54 ssert( p->startT
0750: 69 6d 65 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 ime>0 );. asser
0760: 74 28 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 21 t( db->xProfile!
0770: 3d 30 20 7c 7c 20 28 64 62 2d 3e 6d 54 72 61 63 =0 || (db->mTrac
0780: 65 20 26 20 53 51 4c 49 54 45 5f 54 52 41 43 45 e & SQLITE_TRACE
0790: 5f 50 52 4f 46 49 4c 45 29 21 3d 30 20 29 3b 0a _PROFILE)!=0 );.
07a0: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e assert( db->in
07b0: 69 74 2e 62 75 73 79 3d 3d 30 20 29 3b 0a 20 20 it.busy==0 );.
07c0: 61 73 73 65 72 74 28 20 70 2d 3e 7a 53 71 6c 21 assert( p->zSql!
07d0: 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 4f =0 );. sqlite3O
07e0: 73 43 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36 sCurrentTimeInt6
07f0: 34 28 64 62 2d 3e 70 56 66 73 2c 20 26 69 4e 6f 4(db->pVfs, &iNo
0800: 77 29 3b 0a 20 20 69 45 6c 61 70 73 65 20 3d 20 w);. iElapse =
0810: 28 69 4e 6f 77 20 2d 20 70 2d 3e 73 74 61 72 74 (iNow - p->start
0820: 54 69 6d 65 29 2a 31 30 30 30 30 30 30 3b 0a 20 Time)*1000000;.
0830: 20 69 66 28 20 64 62 2d 3e 78 50 72 6f 66 69 6c if( db->xProfil
0840: 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 e ){. db->xPr
0850: 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72 6f 66 69 ofile(db->pProfi
0860: 6c 65 41 72 67 2c 20 70 2d 3e 7a 53 71 6c 2c 20 leArg, p->zSql,
0870: 69 45 6c 61 70 73 65 29 3b 0a 20 20 7d 0a 20 20 iElapse);. }.
0880: 69 66 28 20 64 62 2d 3e 6d 54 72 61 63 65 20 26 if( db->mTrace &
0890: 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 50 52 SQLITE_TRACE_PR
08a0: 4f 46 49 4c 45 20 29 7b 0a 20 20 20 20 64 62 2d OFILE ){. db-
08b0: 3e 78 54 72 61 63 65 28 53 51 4c 49 54 45 5f 54 >xTrace(SQLITE_T
08c0: 52 41 43 45 5f 50 52 4f 46 49 4c 45 2c 20 64 62 RACE_PROFILE, db
08d0: 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 70 2c 20 ->pTraceArg, p,
08e0: 28 76 6f 69 64 2a 29 26 69 45 6c 61 70 73 65 29 (void*)&iElapse)
08f0: 3b 0a 20 20 7d 0a 20 20 70 2d 3e 73 74 61 72 74 ;. }. p->start
0900: 54 69 6d 65 20 3d 20 30 3b 0a 7d 0a 2f 2a 0a 2a Time = 0;.}./*.*
0910: 2a 20 54 68 65 20 63 68 65 63 6b 50 72 6f 66 69 * The checkProfi
0920: 6c 65 43 61 6c 6c 62 61 63 6b 28 44 42 2c 50 29 leCallback(DB,P)
0930: 20 6d 61 63 72 6f 20 63 68 65 63 6b 73 20 74 6f macro checks to
0940: 20 73 65 65 20 69 66 20 61 20 70 72 6f 66 69 6c see if a profil
0950: 65 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 e callback.** is
0960: 20 6e 65 65 64 65 64 2c 20 61 6e 64 20 69 74 20 needed, and it
0970: 69 6e 76 6f 6b 65 73 20 74 68 65 20 63 61 6c 6c invokes the call
0980: 62 61 63 6b 20 69 66 20 69 74 20 69 73 20 6e 65 back if it is ne
0990: 65 64 65 64 2e 0a 2a 2f 0a 23 20 64 65 66 69 6e eded..*/.# defin
09a0: 65 20 63 68 65 63 6b 50 72 6f 66 69 6c 65 43 61 e checkProfileCa
09b0: 6c 6c 62 61 63 6b 28 44 42 2c 50 29 20 5c 0a 20 llback(DB,P) \.
09c0: 20 20 69 66 28 20 28 28 50 29 2d 3e 73 74 61 72 if( ((P)->star
09d0: 74 54 69 6d 65 29 3e 30 20 29 7b 20 69 6e 76 6f tTime)>0 ){ invo
09e0: 6b 65 50 72 6f 66 69 6c 65 43 61 6c 6c 62 61 63 keProfileCallbac
09f0: 6b 28 44 42 2c 50 29 3b 20 7d 0a 23 65 6c 73 65 k(DB,P); }.#else
0a00: 0a 23 20 64 65 66 69 6e 65 20 63 68 65 63 6b 50 .# define checkP
0a10: 72 6f 66 69 6c 65 43 61 6c 6c 62 61 63 6b 28 44 rofileCallback(D
0a20: 42 2c 50 29 20 20 2f 2a 6e 6f 2d 6f 70 2a 2f 0a B,P) /*no-op*/.
0a30: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
0a40: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 e following rout
0a50: 69 6e 65 20 64 65 73 74 72 6f 79 73 20 61 20 76 ine destroys a v
0a60: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 irtual machine t
0a70: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 62 hat is created b
0a80: 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74 65 33 y.** the sqlite3
0a90: 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74 69 _compile() routi
0aa0: 6e 65 2e 20 54 68 65 20 69 6e 74 65 67 65 72 20 ne. The integer
0ab0: 72 65 74 75 72 6e 65 64 20 69 73 20 61 6e 20 53 returned is an S
0ac0: 51 4c 49 54 45 5f 0a 2a 2a 20 73 75 63 63 65 73 QLITE_.** succes
0ad0: 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 65 20 74 s/failure code t
0ae0: 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 hat describes th
0af0: 65 20 72 65 73 75 6c 74 20 6f 66 20 65 78 65 63 e result of exec
0b00: 75 74 69 6e 67 20 74 68 65 20 76 69 72 74 75 61 uting the virtua
0b10: 6c 0a 2a 2a 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a l.** machine..**
0b20: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
0b30: 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 sets the error
0b40: 63 6f 64 65 20 61 6e 64 20 73 74 72 69 6e 67 20 code and string
0b50: 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 returned by.** s
0b60: 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 qlite3_errcode()
0b70: 2c 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 , sqlite3_errmsg
0b80: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 65 () and sqlite3_e
0b90: 72 72 6d 73 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e rrmsg16()..*/.in
0ba0: 74 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 t sqlite3_finali
0bb0: 7a 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 ze(sqlite3_stmt
0bc0: 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 20 72 *pStmt){. int r
0bd0: 63 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d c;. if( pStmt==
0be0: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 49 4d 50 4c 0 ){. /* IMPL
0bf0: 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 EMENTATION-OF: R
0c00: 2d 35 37 32 32 38 2d 31 32 39 30 34 20 49 6e 76 -57228-12904 Inv
0c10: 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f 66 69 oking sqlite3_fi
0c20: 6e 61 6c 69 7a 65 28 29 20 6f 6e 20 61 20 4e 55 nalize() on a NU
0c30: 4c 4c 0a 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 LL. ** pointe
0c40: 72 20 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 r is a harmless
0c50: 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 20 20 72 63 no-op. */. rc
0c60: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
0c70: 7d 65 6c 73 65 7b 0a 20 20 20 20 56 64 62 65 20 }else{. Vdbe
0c80: 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d *v = (Vdbe*)pStm
0c90: 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a t;. sqlite3 *
0ca0: 64 62 20 3d 20 76 2d 3e 64 62 3b 0a 20 20 20 20 db = v->db;.
0cb0: 69 66 28 20 76 64 62 65 53 61 66 65 74 79 28 76 if( vdbeSafety(v
0cc0: 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ) ) return SQLIT
0cd0: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
0ce0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
0cf0: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
0d00: 29 3b 0a 20 20 20 20 63 68 65 63 6b 50 72 6f 66 );. checkProf
0d10: 69 6c 65 43 61 6c 6c 62 61 63 6b 28 64 62 2c 20 ileCallback(db,
0d20: 76 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c v);. rc = sql
0d30: 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 ite3VdbeFinalize
0d40: 28 76 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 (v);. rc = sq
0d50: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
0d60: 20 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 rc);. sqlite
0d70: 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
0d80: 6f 73 65 5a 6f 6d 62 69 65 28 64 62 29 3b 0a 20 oseZombie(db);.
0d90: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
0da0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 72 6d 69 6e 61 }../*.** Termina
0db0: 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 te the current e
0dc0: 78 65 63 75 74 69 6f 6e 20 6f 66 20 61 6e 20 53 xecution of an S
0dd0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 QL statement and
0de0: 20 72 65 73 65 74 20 69 74 0a 2a 2a 20 62 61 63 reset it.** bac
0df0: 6b 20 74 6f 20 69 74 73 20 73 74 61 72 74 69 6e k to its startin
0e00: 67 20 73 74 61 74 65 20 73 6f 20 74 68 61 74 20 g state so that
0e10: 69 74 20 63 61 6e 20 62 65 20 72 65 75 73 65 64 it can be reused
0e20: 2e 20 41 20 73 75 63 63 65 73 73 20 63 6f 64 65 . A success code
0e30: 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 70 72 69 from.** the pri
0e40: 6f 72 20 65 78 65 63 75 74 69 6f 6e 20 69 73 20 or execution is
0e50: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 returned..**.**
0e60: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 This routine set
0e70: 73 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 s the error code
0e80: 20 61 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 and string retu
0e90: 72 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 rned by.** sqlit
0ea0: 65 33 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 e3_errcode(), sq
0eb0: 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 lite3_errmsg() a
0ec0: 6e 64 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 nd sqlite3_errms
0ed0: 67 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 g16()..*/.int sq
0ee0: 6c 69 74 65 33 5f 72 65 73 65 74 28 73 71 6c 69 lite3_reset(sqli
0ef0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 te3_stmt *pStmt)
0f00: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 {. int rc;. if
0f10: 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 ( pStmt==0 ){.
0f20: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
0f30: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 56 ;. }else{. V
0f40: 64 62 65 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 dbe *v = (Vdbe*)
0f50: 70 53 74 6d 74 3b 0a 20 20 20 20 73 71 6c 69 74 pStmt;. sqlit
0f60: 65 33 20 2a 64 62 20 3d 20 76 2d 3e 64 62 3b 0a e3 *db = v->db;.
0f70: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
0f80: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
0f90: 78 29 3b 0a 20 20 20 20 63 68 65 63 6b 50 72 6f x);. checkPro
0fa0: 66 69 6c 65 43 61 6c 6c 62 61 63 6b 28 64 62 2c fileCallback(db,
0fb0: 20 76 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 v);. rc = sq
0fc0: 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28 76 lite3VdbeReset(v
0fd0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 );. sqlite3Vd
0fe0: 62 65 52 65 77 69 6e 64 28 76 29 3b 0a 20 20 20 beRewind(v);.
0ff0: 20 61 73 73 65 72 74 28 20 28 72 63 20 26 20 28 assert( (rc & (
1000: 64 62 2d 3e 65 72 72 4d 61 73 6b 29 29 3d 3d 72 db->errMask))==r
1010: 63 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 c );. rc = sq
1020: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
1030: 20 72 63 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 rc);. sqlite
1040: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
1050: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 ->mutex);. }.
1060: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1070: 0a 2a 2a 20 53 65 74 20 61 6c 6c 20 74 68 65 20 .** Set all the
1080: 70 61 72 61 6d 65 74 65 72 73 20 69 6e 20 74 68 parameters in th
1090: 65 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20 73 e compiled SQL s
10a0: 74 61 74 65 6d 65 6e 74 20 74 6f 20 4e 55 4c 4c tatement to NULL
10b0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
10c0: 5f 63 6c 65 61 72 5f 62 69 6e 64 69 6e 67 73 28 _clear_bindings(
10d0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
10e0: 74 6d 74 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 tmt){. int i;.
10f0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
1100: 5f 4f 4b 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d _OK;. Vdbe *p =
1110: 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 23 (Vdbe*)pStmt;.#
1120: 69 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 if SQLITE_THREAD
1130: 53 41 46 45 0a 20 20 73 71 6c 69 74 65 33 5f 6d SAFE. sqlite3_m
1140: 75 74 65 78 20 2a 6d 75 74 65 78 20 3d 20 28 28 utex *mutex = ((
1150: 56 64 62 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 Vdbe*)pStmt)->db
1160: 2d 3e 6d 75 74 65 78 3b 0a 23 65 6e 64 69 66 0a ->mutex;.#endif.
1170: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1180: 65 6e 74 65 72 28 6d 75 74 65 78 29 3b 0a 20 20 enter(mutex);.
1190: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 56 for(i=0; i<p->nV
11a0: 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 ar; i++){. sq
11b0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 lite3VdbeMemRele
11c0: 61 73 65 28 26 70 2d 3e 61 56 61 72 5b 69 5d 29 ase(&p->aVar[i])
11d0: 3b 0a 20 20 20 20 70 2d 3e 61 56 61 72 5b 69 5d ;. p->aVar[i]
11e0: 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c .flags = MEM_Nul
11f0: 6c 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 l;. }. assert(
1200: 20 28 70 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 (p->prepFlags &
1210: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f SQLITE_PREPARE_
1220: 53 41 56 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 SAVESQL)!=0 || p
1230: 2d 3e 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b 0a ->expmask==0 );.
1240: 20 20 69 66 28 20 70 2d 3e 65 78 70 6d 61 73 6b if( p->expmask
1250: 20 29 7b 0a 20 20 20 20 70 2d 3e 65 78 70 69 72 ){. p->expir
1260: 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71 ed = 1;. }. sq
1270: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1280: 65 28 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 e(mutex);. retu
1290: 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 2a 2a 2a rn rc;.}.../****
12a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12b0: 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 ******** sqlite3
12c0: 5f 76 61 6c 75 65 5f 20 20 2a 2a 2a 2a 2a 2a 2a _value_ *******
12d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12e0: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 ********.** The
12f0: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e following routin
1300: 65 73 20 65 78 74 72 61 63 74 20 69 6e 66 6f 72 es extract infor
1310: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 61 20 4d 65 mation from a Me
1320: 6d 20 6f 72 20 73 71 6c 69 74 65 33 5f 76 61 6c m or sqlite3_val
1330: 75 65 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e ue.** structure.
1340: 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a .*/.const void *
1350: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c sqlite3_value_bl
1360: 6f 62 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 ob(sqlite3_value
1370: 20 2a 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20 2a *pVal){. Mem *
1380: 70 20 3d 20 28 4d 65 6d 2a 29 70 56 61 6c 3b 0a p = (Mem*)pVal;.
1390: 20 20 69 66 28 20 70 2d 3e 66 6c 61 67 73 20 26 if( p->flags &
13a0: 20 28 4d 45 4d 5f 42 6c 6f 62 7c 4d 45 4d 5f 53 (MEM_Blob|MEM_S
13b0: 74 72 29 20 29 7b 0a 20 20 20 20 69 66 28 20 45 tr) ){. if( E
13c0: 78 70 61 6e 64 42 6c 6f 62 28 70 29 21 3d 53 51 xpandBlob(p)!=SQ
13d0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
13e0: 20 61 73 73 65 72 74 28 20 70 2d 3e 66 6c 61 67 assert( p->flag
13f0: 73 3d 3d 4d 45 4d 5f 4e 75 6c 6c 20 26 26 20 70 s==MEM_Null && p
1400: 2d 3e 7a 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ->z==0 );.
1410: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a return 0;. }.
1420: 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 7c 3d 20 p->flags |=
1430: 4d 45 4d 5f 42 6c 6f 62 3b 0a 20 20 20 20 72 65 MEM_Blob;. re
1440: 74 75 72 6e 20 70 2d 3e 6e 20 3f 20 70 2d 3e 7a turn p->n ? p->z
1450: 20 3a 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 : 0;. }else{.
1460: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
1470: 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 70 56 61 3_value_text(pVa
1480: 6c 29 3b 0a 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 l);. }.}.int sq
1490: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 lite3_value_byte
14a0: 73 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 s(sqlite3_value
14b0: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e *pVal){. return
14c0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 sqlite3ValueByt
14d0: 65 73 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f es(pVal, SQLITE_
14e0: 55 54 46 38 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c UTF8);.}.int sql
14f0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 ite3_value_bytes
1500: 31 36 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 16(sqlite3_value
1510: 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 *pVal){. retur
1520: 6e 20 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 n sqlite3ValueBy
1530: 74 65 73 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 tes(pVal, SQLITE
1540: 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 7d _UTF16NATIVE);.}
1550: 0a 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 5f .double sqlite3_
1560: 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 73 71 6c value_double(sql
1570: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c ite3_value *pVal
1580: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
1590: 74 65 33 56 64 62 65 52 65 61 6c 56 61 6c 75 65 te3VdbeRealValue
15a0: 28 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a ((Mem*)pVal);.}.
15b0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 int sqlite3_valu
15c0: 65 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f 76 61 e_int(sqlite3_va
15d0: 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 lue *pVal){. re
15e0: 74 75 72 6e 20 28 69 6e 74 29 73 71 6c 69 74 65 turn (int)sqlite
15f0: 33 56 64 62 65 49 6e 74 56 61 6c 75 65 28 28 4d 3VdbeIntValue((M
1600: 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 73 71 6c em*)pVal);.}.sql
1610: 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 ite_int64 sqlite
1620: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 73 71 3_value_int64(sq
1630: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
1640: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
1650: 69 74 65 33 56 64 62 65 49 6e 74 56 61 6c 75 65 ite3VdbeIntValue
1660: 28 28 4d 65 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a ((Mem*)pVal);.}.
1670: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 73 71 6c unsigned int sql
1680: 69 74 65 33 5f 76 61 6c 75 65 5f 73 75 62 74 79 ite3_value_subty
1690: 70 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 pe(sqlite3_value
16a0: 20 2a 70 56 61 6c 29 7b 0a 20 20 4d 65 6d 20 2a *pVal){. Mem *
16b0: 70 4d 65 6d 20 3d 20 28 4d 65 6d 2a 29 70 56 61 pMem = (Mem*)pVa
16c0: 6c 3b 0a 20 20 72 65 74 75 72 6e 20 28 28 70 4d l;. return ((pM
16d0: 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f em->flags & MEM_
16e0: 53 75 62 74 79 70 65 29 20 3f 20 70 4d 65 6d 2d Subtype) ? pMem-
16f0: 3e 65 53 75 62 74 79 70 65 20 3a 20 30 29 3b 0a >eSubtype : 0);.
1700: 7d 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f }.void *sqlite3_
1710: 76 61 6c 75 65 5f 70 6f 69 6e 74 65 72 28 73 71 value_pointer(sq
1720: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
1730: 6c 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a l, const char *z
1740: 50 54 79 70 65 29 7b 0a 20 20 4d 65 6d 20 2a 70 PType){. Mem *p
1750: 20 3d 20 28 4d 65 6d 2a 29 70 56 61 6c 3b 0a 20 = (Mem*)pVal;.
1760: 20 69 66 28 20 28 70 2d 3e 66 6c 61 67 73 26 28 if( (p->flags&(
1770: 4d 45 4d 5f 54 79 70 65 4d 61 73 6b 7c 4d 45 4d MEM_TypeMask|MEM
1780: 5f 54 65 72 6d 7c 4d 45 4d 5f 53 75 62 74 79 70 _Term|MEM_Subtyp
1790: 65 29 29 20 3d 3d 0a 20 20 20 20 20 20 20 20 20 e)) ==.
17a0: 20 20 20 20 20 20 20 20 28 4d 45 4d 5f 4e 75 6c (MEM_Nul
17b0: 6c 7c 4d 45 4d 5f 54 65 72 6d 7c 4d 45 4d 5f 53 l|MEM_Term|MEM_S
17c0: 75 62 74 79 70 65 29 0a 20 20 20 26 26 20 7a 50 ubtype). && zP
17d0: 54 79 70 65 21 3d 30 0a 20 20 20 26 26 20 70 2d Type!=0. && p-
17e0: 3e 65 53 75 62 74 79 70 65 3d 3d 27 70 27 0a 20 >eSubtype=='p'.
17f0: 20 20 26 26 20 73 74 72 63 6d 70 28 70 2d 3e 75 && strcmp(p->u
1800: 2e 7a 50 54 79 70 65 2c 20 7a 50 54 79 70 65 29 .zPType, zPType)
1810: 3d 3d 30 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 ==0. ){. ret
1820: 75 72 6e 20 28 76 6f 69 64 2a 29 70 2d 3e 7a 3b urn (void*)p->z;
1830: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 . }else{. re
1840: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 63 6f turn 0;. }.}.co
1850: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 nst unsigned cha
1860: 72 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 r *sqlite3_value
1870: 5f 74 65 78 74 28 73 71 6c 69 74 65 33 5f 76 61 _text(sqlite3_va
1880: 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 lue *pVal){. re
1890: 74 75 72 6e 20 28 63 6f 6e 73 74 20 75 6e 73 69 turn (const unsi
18a0: 67 6e 65 64 20 63 68 61 72 20 2a 29 73 71 6c 69 gned char *)sqli
18b0: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 te3ValueText(pVa
18c0: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b l, SQLITE_UTF8);
18d0: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 .}.#ifndef SQLIT
18e0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e E_OMIT_UTF16.con
18f0: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 st void *sqlite3
1900: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 71 _value_text16(sq
1910: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61 lite3_value* pVa
1920: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
1930: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
1940: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 al, SQLITE_UTF16
1950: 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 74 NATIVE);.}.const
1960: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 void *sqlite3_v
1970: 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28 73 71 alue_text16be(sq
1980: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
1990: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
19a0: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
19b0: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 al, SQLITE_UTF16
19c0: 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 BE);.}.const voi
19d0: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 d *sqlite3_value
19e0: 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69 74 65 _text16le(sqlite
19f0: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 3_value *pVal){.
1a00: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
1a10: 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 ValueText(pVal,
1a20: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 3b SQLITE_UTF16LE);
1a30: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
1a40: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a ITE_OMIT_UTF16 *
1a50: 2f 0a 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /./* EVIDENCE-OF
1a60: 3a 20 52 2d 31 32 37 39 33 2d 34 33 32 38 33 20 : R-12793-43283
1a70: 45 76 65 72 79 20 76 61 6c 75 65 20 69 6e 20 53 Every value in S
1a80: 51 4c 69 74 65 20 68 61 73 20 6f 6e 65 20 6f 66 QLite has one of
1a90: 20 66 69 76 65 0a 2a 2a 20 66 75 6e 64 61 6d 65 five.** fundame
1aa0: 6e 74 61 6c 20 64 61 74 61 74 79 70 65 73 3a 20 ntal datatypes:
1ab0: 36 34 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 64-bit signed in
1ac0: 74 65 67 65 72 20 36 34 2d 62 69 74 20 49 45 45 teger 64-bit IEE
1ad0: 45 20 66 6c 6f 61 74 69 6e 67 0a 2a 2a 20 70 6f E floating.** po
1ae0: 69 6e 74 20 6e 75 6d 62 65 72 20 73 74 72 69 6e int number strin
1af0: 67 20 42 4c 4f 42 20 4e 55 4c 4c 0a 2a 2f 0a 69 g BLOB NULL.*/.i
1b00: 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt sqlite3_value
1b10: 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 76 61 _type(sqlite3_va
1b20: 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 20 73 74 lue* pVal){. st
1b30: 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 61 54 atic const u8 aT
1b40: 79 70 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 53 ype[] = {. S
1b50: 51 4c 49 54 45 5f 42 4c 4f 42 2c 20 20 20 20 20 QLITE_BLOB,
1b60: 2f 2a 20 30 78 30 30 20 2a 2f 0a 20 20 20 20 20 /* 0x00 */.
1b70: 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 SQLITE_NULL,
1b80: 20 2f 2a 20 30 78 30 31 20 2a 2f 0a 20 20 20 20 /* 0x01 */.
1b90: 20 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 20 20 SQLITE_TEXT,
1ba0: 20 20 2f 2a 20 30 78 30 32 20 2a 2f 0a 20 20 20 /* 0x02 */.
1bb0: 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 SQLITE_NULL,
1bc0: 20 20 20 2f 2a 20 30 78 30 33 20 2a 2f 0a 20 20 /* 0x03 */.
1bd0: 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 SQLITE_INTEGE
1be0: 52 2c 20 20 2f 2a 20 30 78 30 34 20 2a 2f 0a 20 R, /* 0x04 */.
1bf0: 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c SQLITE_NULL,
1c00: 20 20 20 20 20 2f 2a 20 30 78 30 35 20 2a 2f 0a /* 0x05 */.
1c10: 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 SQLITE_INTE
1c20: 47 45 52 2c 20 20 2f 2a 20 30 78 30 36 20 2a 2f GER, /* 0x06 */
1c30: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c . SQLITE_NUL
1c40: 4c 2c 20 20 20 20 20 2f 2a 20 30 78 30 37 20 2a L, /* 0x07 *
1c50: 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 4c /. SQLITE_FL
1c60: 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 30 38 20 OAT, /* 0x08
1c70: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e */. SQLITE_N
1c80: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 30 39 ULL, /* 0x09
1c90: 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f */. SQLITE_
1ca0: 46 4c 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 30 FLOAT, /* 0x0
1cb0: 61 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 a */. SQLITE
1cc0: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 _NULL, /* 0x
1cd0: 30 62 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 0b */. SQLIT
1ce0: 45 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 E_INTEGER, /* 0
1cf0: 78 30 63 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 x0c */. SQLI
1d00: 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 TE_NULL, /*
1d10: 30 78 30 64 20 2a 2f 0a 20 20 20 20 20 53 51 4c 0x0d */. SQL
1d20: 49 54 45 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a ITE_INTEGER, /*
1d30: 20 30 78 30 65 20 2a 2f 0a 20 20 20 20 20 53 51 0x0e */. SQ
1d40: 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f LITE_NULL, /
1d50: 2a 20 30 78 30 66 20 2a 2f 0a 20 20 20 20 20 53 * 0x0f */. S
1d60: 51 4c 49 54 45 5f 42 4c 4f 42 2c 20 20 20 20 20 QLITE_BLOB,
1d70: 2f 2a 20 30 78 31 30 20 2a 2f 0a 20 20 20 20 20 /* 0x10 */.
1d80: 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 SQLITE_NULL,
1d90: 20 2f 2a 20 30 78 31 31 20 2a 2f 0a 20 20 20 20 /* 0x11 */.
1da0: 20 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 20 20 SQLITE_TEXT,
1db0: 20 20 2f 2a 20 30 78 31 32 20 2a 2f 0a 20 20 20 /* 0x12 */.
1dc0: 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 SQLITE_NULL,
1dd0: 20 20 20 2f 2a 20 30 78 31 33 20 2a 2f 0a 20 20 /* 0x13 */.
1de0: 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 SQLITE_INTEGE
1df0: 52 2c 20 20 2f 2a 20 30 78 31 34 20 2a 2f 0a 20 R, /* 0x14 */.
1e00: 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c SQLITE_NULL,
1e10: 20 20 20 20 20 2f 2a 20 30 78 31 35 20 2a 2f 0a /* 0x15 */.
1e20: 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 SQLITE_INTE
1e30: 47 45 52 2c 20 20 2f 2a 20 30 78 31 36 20 2a 2f GER, /* 0x16 */
1e40: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c . SQLITE_NUL
1e50: 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 37 20 2a L, /* 0x17 *
1e60: 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 4c /. SQLITE_FL
1e70: 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 31 38 20 OAT, /* 0x18
1e80: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e */. SQLITE_N
1e90: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 39 ULL, /* 0x19
1ea0: 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f */. SQLITE_
1eb0: 46 4c 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 31 FLOAT, /* 0x1
1ec0: 61 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 a */. SQLITE
1ed0: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 _NULL, /* 0x
1ee0: 31 62 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 1b */. SQLIT
1ef0: 45 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 E_INTEGER, /* 0
1f00: 78 31 63 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 x1c */. SQLI
1f10: 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 TE_NULL, /*
1f20: 30 78 31 64 20 2a 2f 0a 20 20 20 20 20 53 51 4c 0x1d */. SQL
1f30: 49 54 45 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a ITE_INTEGER, /*
1f40: 20 30 78 31 65 20 2a 2f 0a 20 20 20 20 20 53 51 0x1e */. SQ
1f50: 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f LITE_NULL, /
1f60: 2a 20 30 78 31 66 20 2a 2f 0a 20 20 7d 3b 0a 20 * 0x1f */. };.
1f70: 20 72 65 74 75 72 6e 20 61 54 79 70 65 5b 70 56 return aType[pV
1f80: 61 6c 2d 3e 66 6c 61 67 73 26 4d 45 4d 5f 41 66 al->flags&MEM_Af
1f90: 66 4d 61 73 6b 5d 3b 0a 7d 0a 0a 2f 2a 20 4d 61 fMask];.}../* Ma
1fa0: 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 61 6e 20 ke a copy of an
1fb0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 6f 62 sqlite3_value ob
1fc0: 6a 65 63 74 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f ject.*/.sqlite3_
1fd0: 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f 76 value *sqlite3_v
1fe0: 61 6c 75 65 5f 64 75 70 28 63 6f 6e 73 74 20 73 alue_dup(const s
1ff0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 4f qlite3_value *pO
2000: 72 69 67 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f rig){. sqlite3_
2010: 76 61 6c 75 65 20 2a 70 4e 65 77 3b 0a 20 20 69 value *pNew;. i
2020: 66 28 20 70 4f 72 69 67 3d 3d 30 20 29 20 72 65 f( pOrig==0 ) re
2030: 74 75 72 6e 20 30 3b 0a 20 20 70 4e 65 77 20 3d turn 0;. pNew =
2040: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 sqlite3_malloc(
2050: 20 73 69 7a 65 6f 66 28 2a 70 4e 65 77 29 20 29 sizeof(*pNew) )
2060: 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 ;. if( pNew==0
2070: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 6d 65 ) return 0;. me
2080: 6d 73 65 74 28 70 4e 65 77 2c 20 30 2c 20 73 69 mset(pNew, 0, si
2090: 7a 65 6f 66 28 2a 70 4e 65 77 29 29 3b 0a 20 20 zeof(*pNew));.
20a0: 6d 65 6d 63 70 79 28 70 4e 65 77 2c 20 70 4f 72 memcpy(pNew, pOr
20b0: 69 67 2c 20 4d 45 4d 43 45 4c 4c 53 49 5a 45 29 ig, MEMCELLSIZE)
20c0: 3b 0a 20 20 70 4e 65 77 2d 3e 66 6c 61 67 73 20 ;. pNew->flags
20d0: 26 3d 20 7e 4d 45 4d 5f 44 79 6e 3b 0a 20 20 70 &= ~MEM_Dyn;. p
20e0: 4e 65 77 2d 3e 64 62 20 3d 20 30 3b 0a 20 20 69 New->db = 0;. i
20f0: 66 28 20 70 4e 65 77 2d 3e 66 6c 61 67 73 26 28 f( pNew->flags&(
2100: 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 42 6c 6f 62 MEM_Str|MEM_Blob
2110: 29 20 29 7b 0a 20 20 20 20 70 4e 65 77 2d 3e 66 ) ){. pNew->f
2120: 6c 61 67 73 20 26 3d 20 7e 28 4d 45 4d 5f 53 74 lags &= ~(MEM_St
2130: 61 74 69 63 7c 4d 45 4d 5f 44 79 6e 29 3b 0a 20 atic|MEM_Dyn);.
2140: 20 20 20 70 4e 65 77 2d 3e 66 6c 61 67 73 20 7c pNew->flags |
2150: 3d 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 = MEM_Ephem;.
2160: 20 69 66 28 20 73 71 6c 69 74 65 33 56 64 62 65 if( sqlite3Vdbe
2170: 4d 65 6d 4d 61 6b 65 57 72 69 74 65 61 62 6c 65 MemMakeWriteable
2180: 28 70 4e 65 77 29 21 3d 53 51 4c 49 54 45 5f 4f (pNew)!=SQLITE_O
2190: 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
21a0: 65 33 56 61 6c 75 65 46 72 65 65 28 70 4e 65 77 e3ValueFree(pNew
21b0: 29 3b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 );. pNew =
21c0: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 0;. }. }. r
21d0: 65 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f eturn pNew;.}../
21e0: 2a 20 44 65 73 74 72 6f 79 20 61 6e 20 73 71 6c * Destroy an sql
21f0: 69 74 65 33 5f 76 61 6c 75 65 20 6f 62 6a 65 63 ite3_value objec
2200: 74 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 62 74 t previously obt
2210: 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 73 71 ained from.** sq
2220: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 75 70 28 lite3_value_dup(
2230: 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 )..*/.void sqlit
2240: 65 33 5f 76 61 6c 75 65 5f 66 72 65 65 28 73 71 e3_value_free(sq
2250: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 4f 6c lite3_value *pOl
2260: 64 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c d){. sqlite3Val
2270: 75 65 46 72 65 65 28 70 4f 6c 64 29 3b 0a 7d 0a ueFree(pOld);.}.
2280: 20 20 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ../***********
2290: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
22a0: 2a 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 * sqlite3_result
22b0: 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a _ *************
22c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
22d0: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 **.** The follow
22e0: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61 72 65 ing routines are
22f0: 20 75 73 65 64 20 62 79 20 75 73 65 72 2d 64 65 used by user-de
2300: 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 fined functions
2310: 74 6f 20 73 70 65 63 69 66 79 0a 2a 2a 20 74 68 to specify.** th
2320: 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 73 75 6c e function resul
2330: 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 65 74 t..**.** The set
2340: 53 74 72 4f 72 45 72 72 6f 72 28 29 20 66 75 6e StrOrError() fun
2350: 63 74 69 6f 6e 20 63 61 6c 6c 73 20 73 71 6c 69 ction calls sqli
2360: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 te3VdbeMemSetStr
2370: 28 29 20 74 6f 20 73 74 6f 72 65 20 74 68 65 0a () to store the.
2380: 2a 2a 20 72 65 73 75 6c 74 20 61 73 20 61 20 73 ** result as a s
2390: 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 62 75 tring or blob bu
23a0: 74 20 69 66 20 74 68 65 20 73 74 72 69 6e 67 20 t if the string
23b0: 6f 72 20 62 6c 6f 62 20 69 73 20 74 6f 6f 20 6c or blob is too l
23c0: 61 72 67 65 2c 20 69 74 0a 2a 2a 20 74 68 65 6e arge, it.** then
23d0: 20 73 65 74 73 20 74 68 65 20 65 72 72 6f 72 20 sets the error
23e0: 63 6f 64 65 20 74 6f 20 53 51 4c 49 54 45 5f 54 code to SQLITE_T
23f0: 4f 4f 42 49 47 0a 2a 2a 0a 2a 2a 20 54 68 65 20 OOBIG.**.** The
2400: 69 6e 76 6f 6b 65 56 61 6c 75 65 44 65 73 74 72 invokeValueDestr
2410: 75 63 74 6f 72 28 50 2c 58 29 20 72 6f 75 74 69 uctor(P,X) routi
2420: 6e 65 20 69 6e 76 6f 6b 65 73 20 64 65 73 74 72 ne invokes destr
2430: 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 58 uctor function X
2440: 28 29 0a 2a 2a 20 6f 6e 20 76 61 6c 75 65 20 50 ().** on value P
2450: 20 69 73 20 6e 6f 74 20 67 6f 69 6e 67 20 74 6f is not going to
2460: 20 62 65 20 75 73 65 64 20 61 6e 64 20 6e 65 65 be used and nee
2470: 64 20 74 6f 20 62 65 20 64 65 73 74 72 6f 79 65 d to be destroye
2480: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 d..*/.static voi
2490: 64 20 73 65 74 52 65 73 75 6c 74 53 74 72 4f 72 d setResultStrOr
24a0: 45 72 72 6f 72 28 0a 20 20 73 71 6c 69 74 65 33 Error(. sqlite3
24b0: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 _context *pCtx,
24c0: 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 63 6f 6e /* Function con
24d0: 74 65 78 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 text */. const
24e0: 63 68 61 72 20 2a 7a 2c 20 20 20 20 20 20 20 20 char *z,
24f0: 20 20 2f 2a 20 53 74 72 69 6e 67 20 70 6f 69 6e /* String poin
2500: 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 2c 20 ter */. int n,
2510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2520: 20 2f 2a 20 42 79 74 65 73 20 69 6e 20 73 74 72 /* Bytes in str
2530: 69 6e 67 2c 20 6f 72 20 6e 65 67 61 74 69 76 65 ing, or negative
2540: 20 2a 2f 0a 20 20 75 38 20 65 6e 63 2c 20 20 20 */. u8 enc,
2550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2560: 20 45 6e 63 6f 64 69 6e 67 20 6f 66 20 7a 2e 20 Encoding of z.
2570: 20 30 20 66 6f 72 20 42 4c 4f 42 73 20 2a 2f 0a 0 for BLOBs */.
2580: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 void (*xDel)(v
2590: 6f 69 64 2a 29 20 20 20 20 20 2f 2a 20 44 65 73 oid*) /* Des
25a0: 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e tructor function
25b0: 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 73 71 6c */.){. if( sql
25c0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 ite3VdbeMemSetSt
25d0: 72 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 7a 2c r(pCtx->pOut, z,
25e0: 20 6e 2c 20 65 6e 63 2c 20 78 44 65 6c 29 3d 3d n, enc, xDel)==
25f0: 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 20 29 7b SQLITE_TOOBIG ){
2600: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 . sqlite3_res
2610: 75 6c 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 67 ult_error_toobig
2620: 28 70 43 74 78 29 3b 0a 20 20 7d 0a 7d 0a 73 74 (pCtx);. }.}.st
2630: 61 74 69 63 20 69 6e 74 20 69 6e 76 6f 6b 65 56 atic int invokeV
2640: 61 6c 75 65 44 65 73 74 72 75 63 74 6f 72 28 0a alueDestructor(.
2650: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 2c const void *p,
2660: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2670: 56 61 6c 75 65 20 74 6f 20 64 65 73 74 72 6f 79 Value to destroy
2680: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 */. void (*xDe
2690: 6c 29 28 76 6f 69 64 2a 29 2c 20 20 20 20 20 20 l)(void*),
26a0: 20 2f 2a 20 54 68 65 20 64 65 73 74 72 75 63 74 /* The destruct
26b0: 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f or */. sqlite3_
26c0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 20 20 20 context *pCtx
26d0: 20 20 20 2f 2a 20 53 65 74 20 61 20 53 51 4c 49 /* Set a SQLI
26e0: 54 45 5f 54 4f 4f 42 49 47 20 65 72 72 6f 72 20 TE_TOOBIG error
26f0: 69 66 20 6e 6f 20 4e 55 4c 4c 20 2a 2f 0a 29 7b if no NULL */.){
2700: 0a 20 20 61 73 73 65 72 74 28 20 78 44 65 6c 21 . assert( xDel!
2710: 3d 53 51 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 =SQLITE_DYNAMIC
2720: 29 3b 0a 20 20 69 66 28 20 78 44 65 6c 3d 3d 30 );. if( xDel==0
2730: 20 29 7b 0a 20 20 20 20 2f 2a 20 6e 6f 6f 70 20 ){. /* noop
2740: 2a 2f 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 78 */. }else if( x
2750: 44 65 6c 3d 3d 53 51 4c 49 54 45 5f 54 52 41 4e Del==SQLITE_TRAN
2760: 53 49 45 4e 54 20 29 7b 0a 20 20 20 20 2f 2a 20 SIENT ){. /*
2770: 6e 6f 6f 70 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b noop */. }else{
2780: 0a 20 20 20 20 78 44 65 6c 28 28 76 6f 69 64 2a . xDel((void*
2790: 29 70 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 )p);. }. if( p
27a0: 43 74 78 20 29 20 73 71 6c 69 74 65 33 5f 72 65 Ctx ) sqlite3_re
27b0: 73 75 6c 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 sult_error_toobi
27c0: 67 28 70 43 74 78 29 3b 0a 20 20 72 65 74 75 72 g(pCtx);. retur
27d0: 6e 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3b n SQLITE_TOOBIG;
27e0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f .}.void sqlite3_
27f0: 72 65 73 75 6c 74 5f 62 6c 6f 62 28 0a 20 20 73 result_blob(. s
2800: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
2810: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 pCtx, . const v
2820: 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e oid *z, . int n
2830: 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c , . void (*xDel
2840: 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 )(void *).){. a
2850: 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a 20 ssert( n>=0 );.
2860: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2870: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 _mutex_held(pCtx
2880: 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 ->pOut->db->mute
2890: 78 29 20 29 3b 0a 20 20 73 65 74 52 65 73 75 6c x) );. setResul
28a0: 74 53 74 72 4f 72 45 72 72 6f 72 28 70 43 74 78 tStrOrError(pCtx
28b0: 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78 44 65 6c 29 , z, n, 0, xDel)
28c0: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 ;.}.void sqlite3
28d0: 5f 72 65 73 75 6c 74 5f 62 6c 6f 62 36 34 28 0a _result_blob64(.
28e0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 sqlite3_contex
28f0: 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 t *pCtx, . cons
2900: 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 73 71 t void *z, . sq
2910: 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6e 2c 0a lite3_uint64 n,.
2920: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 void (*xDel)(v
2930: 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 oid *).){. asse
2940: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
2950: 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 x_held(pCtx->pOu
2960: 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b t->db->mutex) );
2970: 0a 20 20 61 73 73 65 72 74 28 20 78 44 65 6c 21 . assert( xDel!
2980: 3d 53 51 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 =SQLITE_DYNAMIC
2990: 29 3b 0a 20 20 69 66 28 20 6e 3e 30 78 37 66 66 );. if( n>0x7ff
29a0: 66 66 66 66 66 20 29 7b 0a 20 20 20 20 28 76 6f fffff ){. (vo
29b0: 69 64 29 69 6e 76 6f 6b 65 56 61 6c 75 65 44 65 id)invokeValueDe
29c0: 73 74 72 75 63 74 6f 72 28 7a 2c 20 78 44 65 6c structor(z, xDel
29d0: 2c 20 70 43 74 78 29 3b 0a 20 20 7d 65 6c 73 65 , pCtx);. }else
29e0: 7b 0a 20 20 20 20 73 65 74 52 65 73 75 6c 74 53 {. setResultS
29f0: 74 72 4f 72 45 72 72 6f 72 28 70 43 74 78 2c 20 trOrError(pCtx,
2a00: 7a 2c 20 28 69 6e 74 29 6e 2c 20 30 2c 20 78 44 z, (int)n, 0, xD
2a10: 65 6c 29 3b 0a 20 20 7d 0a 7d 0a 76 6f 69 64 20 el);. }.}.void
2a20: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 sqlite3_result_d
2a30: 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f ouble(sqlite3_co
2a40: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 ntext *pCtx, dou
2a50: 62 6c 65 20 72 56 61 6c 29 7b 0a 20 20 61 73 73 ble rVal){. ass
2a60: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
2a70: 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f ex_held(pCtx->pO
2a80: 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ut->db->mutex) )
2a90: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d ;. sqlite3VdbeM
2aa0: 65 6d 53 65 74 44 6f 75 62 6c 65 28 70 43 74 78 emSetDouble(pCtx
2ab0: 2d 3e 70 4f 75 74 2c 20 72 56 61 6c 29 3b 0a 7d ->pOut, rVal);.}
2ac0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 .void sqlite3_re
2ad0: 73 75 6c 74 5f 65 72 72 6f 72 28 73 71 6c 69 74 sult_error(sqlit
2ae0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 e3_context *pCtx
2af0: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c , const char *z,
2b00: 20 69 6e 74 20 6e 29 7b 0a 20 20 61 73 73 65 72 int n){. asser
2b10: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
2b20: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 _held(pCtx->pOut
2b30: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
2b40: 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 pCtx->isError
2b50: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
2b60: 20 20 70 43 74 78 2d 3e 66 45 72 72 6f 72 4f 72 pCtx->fErrorOr
2b70: 41 75 78 20 3d 20 31 3b 0a 20 20 73 71 6c 69 74 Aux = 1;. sqlit
2b80: 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 e3VdbeMemSetStr(
2b90: 70 43 74 78 2d 3e 70 4f 75 74 2c 20 7a 2c 20 6e pCtx->pOut, z, n
2ba0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 , SQLITE_UTF8, S
2bb0: 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 QLITE_TRANSIENT)
2bc0: 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ;.}.#ifndef SQLI
2bd0: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 76 6f TE_OMIT_UTF16.vo
2be0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c id sqlite3_resul
2bf0: 74 5f 65 72 72 6f 72 31 36 28 73 71 6c 69 74 65 t_error16(sqlite
2c00: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 3_context *pCtx,
2c10: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 const void *z,
2c20: 69 6e 74 20 6e 29 7b 0a 20 20 61 73 73 65 72 74 int n){. assert
2c30: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2c40: 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d held(pCtx->pOut-
2c50: 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 >db->mutex) );.
2c60: 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d pCtx->isError =
2c70: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
2c80: 20 70 43 74 78 2d 3e 66 45 72 72 6f 72 4f 72 41 pCtx->fErrorOrA
2c90: 75 78 20 3d 20 31 3b 0a 20 20 73 71 6c 69 74 65 ux = 1;. sqlite
2ca0: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 3VdbeMemSetStr(p
2cb0: 43 74 78 2d 3e 70 4f 75 74 2c 20 7a 2c 20 6e 2c Ctx->pOut, z, n,
2cc0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
2cd0: 49 56 45 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e IVE, SQLITE_TRAN
2ce0: 53 49 45 4e 54 29 3b 0a 7d 0a 23 65 6e 64 69 66 SIENT);.}.#endif
2cf0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 .void sqlite3_re
2d00: 73 75 6c 74 5f 69 6e 74 28 73 71 6c 69 74 65 33 sult_int(sqlite3
2d10: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 _context *pCtx,
2d20: 69 6e 74 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 int iVal){. ass
2d30: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
2d40: 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f ex_held(pCtx->pO
2d50: 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ut->db->mutex) )
2d60: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d ;. sqlite3VdbeM
2d70: 65 6d 53 65 74 49 6e 74 36 34 28 70 43 74 78 2d emSetInt64(pCtx-
2d80: 3e 70 4f 75 74 2c 20 28 69 36 34 29 69 56 61 6c >pOut, (i64)iVal
2d90: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 );.}.void sqlite
2da0: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 73 3_result_int64(s
2db0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
2dc0: 70 43 74 78 2c 20 69 36 34 20 69 56 61 6c 29 7b pCtx, i64 iVal){
2dd0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
2de0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 e3_mutex_held(pC
2df0: 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 tx->pOut->db->mu
2e00: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
2e10: 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 3VdbeMemSetInt64
2e20: 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 69 56 61 (pCtx->pOut, iVa
2e30: 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 l);.}.void sqlit
2e40: 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 73 e3_result_null(s
2e50: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
2e60: 70 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74 28 pCtx){. assert(
2e70: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2e80: 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e eld(pCtx->pOut->
2e90: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
2ea0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 sqlite3VdbeMemSe
2eb0: 74 4e 75 6c 6c 28 70 43 74 78 2d 3e 70 4f 75 74 tNull(pCtx->pOut
2ec0: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 );.}.void sqlite
2ed0: 33 5f 72 65 73 75 6c 74 5f 70 6f 69 6e 74 65 72 3_result_pointer
2ee0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 (. sqlite3_cont
2ef0: 65 78 74 20 2a 70 43 74 78 2c 0a 20 20 76 6f 69 ext *pCtx,. voi
2f00: 64 20 2a 70 50 74 72 2c 0a 20 20 63 6f 6e 73 74 d *pPtr,. const
2f10: 20 63 68 61 72 20 2a 7a 50 54 79 70 65 2c 0a 20 char *zPType,.
2f20: 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 75 63 void (*xDestruc
2f30: 74 6f 72 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 tor)(void*).){.
2f40: 20 4d 65 6d 20 2a 70 4f 75 74 20 3d 20 70 43 74 Mem *pOut = pCt
2f50: 78 2d 3e 70 4f 75 74 3b 0a 20 20 61 73 73 65 72 x->pOut;. asser
2f60: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
2f70: 5f 68 65 6c 64 28 70 4f 75 74 2d 3e 64 62 2d 3e _held(pOut->db->
2f80: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
2f90: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e 75 6c te3VdbeMemSetNul
2fa0: 6c 28 70 4f 75 74 29 3b 0a 20 20 73 71 6c 69 74 l(pOut);. sqlit
2fb0: 65 33 56 64 62 65 4d 65 6d 53 65 74 50 6f 69 6e e3VdbeMemSetPoin
2fc0: 74 65 72 28 70 4f 75 74 2c 20 70 50 74 72 2c 20 ter(pOut, pPtr,
2fd0: 7a 50 54 79 70 65 2c 20 78 44 65 73 74 72 75 63 zPType, xDestruc
2fe0: 74 6f 72 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c tor);.}.void sql
2ff0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 73 75 62 74 ite3_result_subt
3000: 79 70 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 ype(sqlite3_cont
3010: 65 78 74 20 2a 70 43 74 78 2c 20 75 6e 73 69 67 ext *pCtx, unsig
3020: 6e 65 64 20 69 6e 74 20 65 53 75 62 74 79 70 65 ned int eSubtype
3030: 29 7b 0a 20 20 4d 65 6d 20 2a 70 4f 75 74 20 3d ){. Mem *pOut =
3040: 20 70 43 74 78 2d 3e 70 4f 75 74 3b 0a 20 20 61 pCtx->pOut;. a
3050: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
3060: 75 74 65 78 5f 68 65 6c 64 28 70 4f 75 74 2d 3e utex_held(pOut->
3070: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
3080: 70 4f 75 74 2d 3e 65 53 75 62 74 79 70 65 20 3d pOut->eSubtype =
3090: 20 65 53 75 62 74 79 70 65 20 26 20 30 78 66 66 eSubtype & 0xff
30a0: 3b 0a 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 ;. pOut->flags
30b0: 7c 3d 20 4d 45 4d 5f 53 75 62 74 79 70 65 3b 0a |= MEM_Subtype;.
30c0: 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 }.void sqlite3_r
30d0: 65 73 75 6c 74 5f 74 65 78 74 28 0a 20 20 73 71 esult_text(. sq
30e0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 lite3_context *p
30f0: 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 Ctx, . const ch
3100: 61 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c ar *z, . int n,
3110: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 . void (*xDel)(
3120: 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 void *).){. ass
3130: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
3140: 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f ex_held(pCtx->pO
3150: 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ut->db->mutex) )
3160: 3b 0a 20 20 73 65 74 52 65 73 75 6c 74 53 74 72 ;. setResultStr
3170: 4f 72 45 72 72 6f 72 28 70 43 74 78 2c 20 7a 2c OrError(pCtx, z,
3180: 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c n, SQLITE_UTF8,
3190: 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 xDel);.}.void s
31a0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 qlite3_result_te
31b0: 78 74 36 34 28 0a 20 20 73 71 6c 69 74 65 33 5f xt64(. sqlite3_
31c0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a context *pCtx, .
31d0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c const char *z,
31e0: 20 0a 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 . sqlite3_uint
31f0: 36 34 20 6e 2c 0a 20 20 76 6f 69 64 20 28 2a 78 64 n,. void (*x
3200: 44 65 6c 29 28 76 6f 69 64 20 2a 29 2c 0a 20 20 Del)(void *),.
3210: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 65 6e unsigned char en
3220: 63 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 c.){. assert( s
3230: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
3240: 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 d(pCtx->pOut->db
3250: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
3260: 73 65 72 74 28 20 78 44 65 6c 21 3d 53 51 4c 49 sert( xDel!=SQLI
3270: 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a 20 20 TE_DYNAMIC );.
3280: 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f if( enc==SQLITE_
3290: 55 54 46 31 36 20 29 20 65 6e 63 20 3d 20 53 51 UTF16 ) enc = SQ
32a0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
32b0: 3b 0a 20 20 69 66 28 20 6e 3e 30 78 37 66 66 66 ;. if( n>0x7fff
32c0: 66 66 66 66 20 29 7b 0a 20 20 20 20 28 76 6f 69 ffff ){. (voi
32d0: 64 29 69 6e 76 6f 6b 65 56 61 6c 75 65 44 65 73 d)invokeValueDes
32e0: 74 72 75 63 74 6f 72 28 7a 2c 20 78 44 65 6c 2c tructor(z, xDel,
32f0: 20 70 43 74 78 29 3b 0a 20 20 7d 65 6c 73 65 7b pCtx);. }else{
3300: 0a 20 20 20 20 73 65 74 52 65 73 75 6c 74 53 74 . setResultSt
3310: 72 4f 72 45 72 72 6f 72 28 70 43 74 78 2c 20 7a rOrError(pCtx, z
3320: 2c 20 28 69 6e 74 29 6e 2c 20 65 6e 63 2c 20 78 , (int)n, enc, x
3330: 44 65 6c 29 3b 0a 20 20 7d 0a 7d 0a 23 69 66 6e Del);. }.}.#ifn
3340: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
3350: 55 54 46 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 UTF16.void sqlit
3360: 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 e3_result_text16
3370: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 (. sqlite3_cont
3380: 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f ext *pCtx, . co
3390: 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 nst void *z, .
33a0: 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 int n, . void (
33b0: 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 *xDel)(void *).)
33c0: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 {. assert( sqli
33d0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
33e0: 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d Ctx->pOut->db->m
33f0: 75 74 65 78 29 20 29 3b 0a 20 20 73 65 74 52 65 utex) );. setRe
3400: 73 75 6c 74 53 74 72 4f 72 45 72 72 6f 72 28 70 sultStrOrError(p
3410: 43 74 78 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 Ctx, z, n, SQLIT
3420: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 78 E_UTF16NATIVE, x
3430: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c Del);.}.void sql
3440: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 ite3_result_text
3450: 31 36 62 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 16be(. sqlite3_
3460: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a context *pCtx, .
3470: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c const void *z,
3480: 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f . int n, . vo
3490: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 id (*xDel)(void
34a0: 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 *).){. assert(
34b0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
34c0: 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 ld(pCtx->pOut->d
34d0: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
34e0: 65 74 52 65 73 75 6c 74 53 74 72 4f 72 45 72 72 etResultStrOrErr
34f0: 6f 72 28 70 43 74 78 2c 20 7a 2c 20 6e 2c 20 53 or(pCtx, z, n, S
3500: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 78 QLITE_UTF16BE, x
3510: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c Del);.}.void sql
3520: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 ite3_result_text
3530: 31 36 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 16le(. sqlite3_
3540: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a context *pCtx, .
3550: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c const void *z,
3560: 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f . int n, . vo
3570: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 id (*xDel)(void
3580: 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 *).){. assert(
3590: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
35a0: 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 ld(pCtx->pOut->d
35b0: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
35c0: 65 74 52 65 73 75 6c 74 53 74 72 4f 72 45 72 72 etResultStrOrErr
35d0: 6f 72 28 70 43 74 78 2c 20 7a 2c 20 6e 2c 20 53 or(pCtx, z, n, S
35e0: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 78 QLITE_UTF16LE, x
35f0: 44 65 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f Del);.}.#endif /
3600: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
3610: 46 31 36 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 F16 */.void sqli
3620: 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75 65 te3_result_value
3630: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
3640: 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65 33 5f *pCtx, sqlite3_
3650: 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29 7b 0a value *pValue){.
3660: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
3670: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 3_mutex_held(pCt
3680: 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 x->pOut->db->mut
3690: 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 ex) );. sqlite3
36a0: 56 64 62 65 4d 65 6d 43 6f 70 79 28 70 43 74 78 VdbeMemCopy(pCtx
36b0: 2d 3e 70 4f 75 74 2c 20 70 56 61 6c 75 65 29 3b ->pOut, pValue);
36c0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f .}.void sqlite3_
36d0: 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f 62 28 result_zeroblob(
36e0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
36f0: 2a 70 43 74 78 2c 20 69 6e 74 20 6e 29 7b 0a 20 *pCtx, int n){.
3700: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
3710: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 _mutex_held(pCtx
3720: 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 ->pOut->db->mute
3730: 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 x) );. sqlite3V
3740: 64 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f dbeMemSetZeroBlo
3750: 62 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 6e 29 b(pCtx->pOut, n)
3760: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ;.}.int sqlite3_
3770: 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f 62 36 result_zeroblob6
3780: 34 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 4(sqlite3_contex
3790: 74 20 2a 70 43 74 78 2c 20 75 36 34 20 6e 29 7b t *pCtx, u64 n){
37a0: 0a 20 20 4d 65 6d 20 2a 70 4f 75 74 20 3d 20 70 . Mem *pOut = p
37b0: 43 74 78 2d 3e 70 4f 75 74 3b 0a 20 20 61 73 73 Ctx->pOut;. ass
37c0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
37d0: 65 78 5f 68 65 6c 64 28 70 4f 75 74 2d 3e 64 62 ex_held(pOut->db
37e0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 ->mutex) );. if
37f0: 28 20 6e 3e 28 75 36 34 29 70 4f 75 74 2d 3e 64 ( n>(u64)pOut->d
3800: 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 b->aLimit[SQLITE
3810: 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 20 29 _LIMIT_LENGTH] )
3820: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
3830: 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20 7d 0a ITE_TOOBIG;. }.
3840: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d sqlite3VdbeMem
3850: 53 65 74 5a 65 72 6f 42 6c 6f 62 28 70 43 74 78 SetZeroBlob(pCtx
3860: 2d 3e 70 4f 75 74 2c 20 28 69 6e 74 29 6e 29 3b ->pOut, (int)n);
3870: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
3880: 5f 4f 4b 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 _OK;.}.void sqli
3890: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 te3_result_error
38a0: 5f 63 6f 64 65 28 73 71 6c 69 74 65 33 5f 63 6f _code(sqlite3_co
38b0: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 ntext *pCtx, int
38c0: 20 65 72 72 43 6f 64 65 29 7b 0a 20 20 70 43 74 errCode){. pCt
38d0: 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 65 72 72 x->isError = err
38e0: 43 6f 64 65 3b 0a 20 20 70 43 74 78 2d 3e 66 45 Code;. pCtx->fE
38f0: 72 72 6f 72 4f 72 41 75 78 20 3d 20 31 3b 0a 23 rrorOrAux = 1;.#
3900: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
3910: 55 47 0a 20 20 69 66 28 20 70 43 74 78 2d 3e 70 UG. if( pCtx->p
3920: 56 64 62 65 20 29 20 70 43 74 78 2d 3e 70 56 64 Vdbe ) pCtx->pVd
3930: 62 65 2d 3e 72 63 41 70 70 20 3d 20 65 72 72 43 be->rcApp = errC
3940: 6f 64 65 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 ode;.#endif. if
3950: 28 20 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 66 6c ( pCtx->pOut->fl
3960: 61 67 73 20 26 20 4d 45 4d 5f 4e 75 6c 6c 20 29 ags & MEM_Null )
3970: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
3980: 65 4d 65 6d 53 65 74 53 74 72 28 70 43 74 78 2d eMemSetStr(pCtx-
3990: 3e 70 4f 75 74 2c 20 73 71 6c 69 74 65 33 45 72 >pOut, sqlite3Er
39a0: 72 53 74 72 28 65 72 72 43 6f 64 65 29 2c 20 2d rStr(errCode), -
39b0: 31 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 1, .
39c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
39d0: 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 ITE_UTF8, SQLITE
39e0: 5f 53 54 41 54 49 43 29 3b 0a 20 20 7d 0a 7d 0a _STATIC);. }.}.
39f0: 0a 2f 2a 20 46 6f 72 63 65 20 61 6e 20 53 51 4c ./* Force an SQL
3a00: 49 54 45 5f 54 4f 4f 42 49 47 20 65 72 72 6f 72 ITE_TOOBIG error
3a10: 2e 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 . */.void sqlite
3a20: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 74 3_result_error_t
3a30: 6f 6f 62 69 67 28 73 71 6c 69 74 65 33 5f 63 6f oobig(sqlite3_co
3a40: 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20 ntext *pCtx){.
3a50: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
3a60: 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d mutex_held(pCtx-
3a70: 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 >pOut->db->mutex
3a80: 29 20 29 3b 0a 20 20 70 43 74 78 2d 3e 69 73 45 ) );. pCtx->isE
3a90: 72 72 6f 72 20 3d 20 53 51 4c 49 54 45 5f 54 4f rror = SQLITE_TO
3aa0: 4f 42 49 47 3b 0a 20 20 70 43 74 78 2d 3e 66 45 OBIG;. pCtx->fE
3ab0: 72 72 6f 72 4f 72 41 75 78 20 3d 20 31 3b 0a 20 rrorOrAux = 1;.
3ac0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 sqlite3VdbeMemS
3ad0: 65 74 53 74 72 28 70 43 74 78 2d 3e 70 4f 75 74 etStr(pCtx->pOut
3ae0: 2c 20 22 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f , "string or blo
3af0: 62 20 74 6f 6f 20 62 69 67 22 2c 20 2d 31 2c 20 b too big", -1,
3b00: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
3b10: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 55 SQLITE_U
3b20: 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 TF8, SQLITE_STAT
3b30: 49 43 29 3b 0a 7d 0a 0a 2f 2a 20 41 6e 20 53 51 IC);.}../* An SQ
3b40: 4c 49 54 45 5f 4e 4f 4d 45 4d 20 65 72 72 6f 72 LITE_NOMEM error
3b50: 2e 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 . */.void sqlite
3b60: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 3_result_error_n
3b70: 6f 6d 65 6d 28 73 71 6c 69 74 65 33 5f 63 6f 6e omem(sqlite3_con
3b80: 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20 61 text *pCtx){. a
3b90: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
3ba0: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e utex_held(pCtx->
3bb0: 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 pOut->db->mutex)
3bc0: 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 );. sqlite3Vdb
3bd0: 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 70 43 74 78 eMemSetNull(pCtx
3be0: 2d 3e 70 4f 75 74 29 3b 0a 20 20 70 43 74 78 2d ->pOut);. pCtx-
3bf0: 3e 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 >isError = SQLIT
3c00: 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
3c10: 70 43 74 78 2d 3e 66 45 72 72 6f 72 4f 72 41 75 pCtx->fErrorOrAu
3c20: 78 20 3d 20 31 3b 0a 20 20 73 71 6c 69 74 65 33 x = 1;. sqlite3
3c30: 4f 6f 6d 46 61 75 6c 74 28 70 43 74 78 2d 3e 70 OomFault(pCtx->p
3c40: 4f 75 74 2d 3e 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a Out->db);.}../*.
3c50: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
3c60: 20 69 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 is called after
3c70: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 a transaction h
3c80: 61 73 20 62 65 65 6e 20 63 6f 6d 6d 69 74 74 65 as been committe
3c90: 64 2e 20 49 74 20 0a 2a 2a 20 69 6e 76 6f 6b 65 d. It .** invoke
3ca0: 73 20 63 61 6c 6c 62 61 63 6b 73 20 72 65 67 69 s callbacks regi
3cb0: 73 74 65 72 65 64 20 77 69 74 68 20 73 71 6c 69 stered with sqli
3cc0: 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 61 te3_wal_hook() a
3cd0: 73 20 72 65 71 75 69 72 65 64 2e 0a 2a 2f 0a 73 s required..*/.s
3ce0: 74 61 74 69 63 20 69 6e 74 20 64 6f 57 61 6c 43 tatic int doWalC
3cf0: 61 6c 6c 62 61 63 6b 73 28 73 71 6c 69 74 65 33 allbacks(sqlite3
3d00: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 72 63 20 *db){. int rc
3d10: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 69 66 = SQLITE_OK;.#if
3d20: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
3d30: 5f 57 41 4c 0a 20 20 69 6e 74 20 69 3b 0a 20 20 _WAL. int i;.
3d40: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e for(i=0; i<db->n
3d50: 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 Db; i++){. Bt
3d60: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 ree *pBt = db->a
3d70: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 Db[i].pBt;. i
3d80: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 f( pBt ){.
3d90: 69 6e 74 20 6e 45 6e 74 72 79 3b 0a 20 20 20 20 int nEntry;.
3da0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
3db0: 74 65 72 28 70 42 74 29 3b 0a 20 20 20 20 20 20 ter(pBt);.
3dc0: 6e 45 6e 74 72 79 20 3d 20 73 71 6c 69 74 65 33 nEntry = sqlite3
3dd0: 50 61 67 65 72 57 61 6c 43 61 6c 6c 62 61 63 6b PagerWalCallback
3de0: 28 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 (sqlite3BtreePag
3df0: 65 72 28 70 42 74 29 29 3b 0a 20 20 20 20 20 20 er(pBt));.
3e00: 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
3e10: 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 e(pBt);. if
3e20: 28 20 6e 45 6e 74 72 79 3e 30 20 26 26 20 64 62 ( nEntry>0 && db
3e30: 2d 3e 78 57 61 6c 43 61 6c 6c 62 61 63 6b 20 26 ->xWalCallback &
3e40: 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
3e50: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
3e60: 64 62 2d 3e 78 57 61 6c 43 61 6c 6c 62 61 63 6b db->xWalCallback
3e70: 28 64 62 2d 3e 70 57 61 6c 41 72 67 2c 20 64 62 (db->pWalArg, db
3e80: 2c 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 7a 44 62 , db->aDb[i].zDb
3e90: 53 4e 61 6d 65 2c 20 6e 45 6e 74 72 79 29 3b 0a SName, nEntry);.
3ea0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
3eb0: 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 }.#endif. retur
3ec0: 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 n rc;.}.../*.**
3ed0: 45 78 65 63 75 74 65 20 74 68 65 20 73 74 61 74 Execute the stat
3ee0: 65 6d 65 6e 74 20 70 53 74 6d 74 2c 20 65 69 74 ement pStmt, eit
3ef0: 68 65 72 20 75 6e 74 69 6c 20 61 20 72 6f 77 20 her until a row
3f00: 6f 66 20 64 61 74 61 20 69 73 20 72 65 61 64 79 of data is ready
3f10: 2c 20 74 68 65 0a 2a 2a 20 73 74 61 74 65 6d 65 , the.** stateme
3f20: 6e 74 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 nt is completely
3f30: 20 65 78 65 63 75 74 65 64 20 6f 72 20 61 6e 20 executed or an
3f40: 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2a error occurs..**
3f50: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
3f60: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 implements the
3f70: 62 75 6c 6b 20 6f 66 20 74 68 65 20 6c 6f 67 69 bulk of the logi
3f80: 63 20 62 65 68 69 6e 64 20 74 68 65 20 73 71 6c c behind the sql
3f90: 69 74 65 5f 73 74 65 70 28 29 0a 2a 2a 20 41 50 ite_step().** AP
3fa0: 49 2e 20 20 54 68 65 20 6f 6e 6c 79 20 74 68 69 I. The only thi
3fb0: 6e 67 20 6f 6d 69 74 74 65 64 20 69 73 20 74 68 ng omitted is th
3fc0: 65 20 61 75 74 6f 6d 61 74 69 63 20 72 65 63 6f e automatic reco
3fd0: 6d 70 69 6c 65 20 69 66 20 61 20 0a 2a 2a 20 73 mpile if a .** s
3fe0: 63 68 65 6d 61 20 63 68 61 6e 67 65 20 68 61 73 chema change has
3ff0: 20 6f 63 63 75 72 72 65 64 2e 20 20 54 68 61 74 occurred. That
4000: 20 64 65 74 61 69 6c 20 69 73 20 68 61 6e 64 6c detail is handl
4010: 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 6f 75 74 ed by the.** out
4020: 65 72 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 er sqlite3_step(
4030: 29 20 77 72 61 70 70 65 72 20 70 72 6f 63 65 64 ) wrapper proced
4040: 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ure..*/.static i
4050: 6e 74 20 73 71 6c 69 74 65 33 53 74 65 70 28 56 nt sqlite3Step(V
4060: 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 dbe *p){. sqlit
4070: 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63 e3 *db;. int rc
4080: 3b 0a 0a 20 20 61 73 73 65 72 74 28 70 29 3b 0a ;.. assert(p);.
4090: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d if( p->magic!=
40a0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 VDBE_MAGIC_RUN )
40b0: 7b 0a 20 20 20 20 2f 2a 20 57 65 20 75 73 65 64 {. /* We used
40c0: 20 74 6f 20 72 65 71 75 69 72 65 20 74 68 61 74 to require that
40d0: 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 29 sqlite3_reset()
40e0: 20 62 65 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 be called befor
40f0: 65 20 72 65 74 72 79 69 6e 67 0a 20 20 20 20 2a e retrying. *
4100: 2a 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 * sqlite3_step()
4110: 20 61 66 74 65 72 20 61 6e 79 20 65 72 72 6f 72 after any error
4120: 20 6f 72 20 61 66 74 65 72 20 53 51 4c 49 54 45 or after SQLITE
4130: 5f 44 4f 4e 45 2e 20 20 42 75 74 20 62 65 67 69 _DONE. But begi
4140: 6e 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 77 69 74 nning. ** wit
4150: 68 20 76 65 72 73 69 6f 6e 20 33 2e 37 2e 30 2c h version 3.7.0,
4160: 20 77 65 20 63 68 61 6e 67 65 64 20 74 68 69 73 we changed this
4170: 20 73 6f 20 74 68 61 74 20 73 71 6c 69 74 65 33 so that sqlite3
4180: 5f 72 65 73 65 74 28 29 20 77 6f 75 6c 64 0a 20 _reset() would.
4190: 20 20 20 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20 ** be called
41a0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e automatically in
41b0: 73 74 65 61 64 20 6f 66 20 74 68 72 6f 77 69 6e stead of throwin
41c0: 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 49 53 g the SQLITE_MIS
41d0: 55 53 45 20 65 72 72 6f 72 2e 0a 20 20 20 20 2a USE error.. *
41e0: 2a 20 54 68 69 73 20 22 61 75 74 6f 6d 61 74 69 * This "automati
41f0: 63 2d 72 65 73 65 74 22 20 63 68 61 6e 67 65 20 c-reset" change
4200: 69 73 20 6e 6f 74 20 74 65 63 68 6e 69 63 61 6c is not technical
4210: 6c 79 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 ly an incompatib
4220: 69 6c 69 74 79 2c 20 0a 20 20 20 20 2a 2a 20 73 ility, . ** s
4230: 69 6e 63 65 20 61 6e 79 20 61 70 70 6c 69 63 61 ince any applica
4240: 74 69 6f 6e 20 74 68 61 74 20 72 65 63 65 69 76 tion that receiv
4250: 65 73 20 61 6e 20 53 51 4c 49 54 45 5f 4d 49 53 es an SQLITE_MIS
4260: 55 53 45 20 69 73 20 62 72 6f 6b 65 6e 20 62 79 USE is broken by
4270: 0a 20 20 20 20 2a 2a 20 64 65 66 69 6e 69 74 69 . ** definiti
4280: 6f 6e 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a on.. **. *
4290: 2a 20 4e 65 76 65 72 74 68 65 6c 65 73 73 2c 20 * Nevertheless,
42a0: 73 6f 6d 65 20 70 75 62 6c 69 73 68 65 64 20 61 some published a
42b0: 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 68 61 74 pplications that
42c0: 20 77 65 72 65 20 6f 72 69 67 69 6e 61 6c 6c 79 were originally
42d0: 20 77 72 69 74 74 65 6e 0a 20 20 20 20 2a 2a 20 written. **
42e0: 66 6f 72 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e for version 3.6.
42f0: 32 33 20 6f 72 20 65 61 72 6c 69 65 72 20 64 6f 23 or earlier do
4300: 20 69 6e 20 66 61 63 74 20 64 65 70 65 6e 64 20 in fact depend
4310: 6f 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 on SQLITE_MISUSE
4320: 20 0a 20 20 20 20 2a 2a 20 72 65 74 75 72 6e 73 . ** returns
4330: 2c 20 61 6e 64 20 74 68 6f 73 65 20 77 65 72 65 , and those were
4340: 20 62 72 6f 6b 65 6e 20 62 79 20 74 68 65 20 61 broken by the a
4350: 75 74 6f 6d 61 74 69 63 2d 72 65 73 65 74 20 63 utomatic-reset c
4360: 68 61 6e 67 65 2e 20 20 41 73 20 61 0a 20 20 20 hange. As a.
4370: 20 2a 2a 20 61 20 77 6f 72 6b 2d 61 72 6f 75 6e ** a work-aroun
4380: 64 2c 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d d, the SQLITE_OM
4390: 49 54 5f 41 55 54 4f 52 45 53 45 54 20 63 6f 6d IT_AUTORESET com
43a0: 70 69 6c 65 2d 74 69 6d 65 20 72 65 73 74 6f 72 pile-time restor
43b0: 65 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 6c 65 es the. ** le
43c0: 67 61 63 79 20 62 65 68 61 76 69 6f 72 20 6f 66 gacy behavior of
43d0: 20 72 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 returning SQLIT
43e0: 45 5f 4d 49 53 55 53 45 20 66 6f 72 20 63 61 73 E_MISUSE for cas
43f0: 65 73 20 77 68 65 72 65 20 74 68 65 20 0a 20 20 es where the .
4400: 20 20 2a 2a 20 70 72 65 76 69 6f 75 73 20 73 71 ** previous sq
4410: 6c 69 74 65 33 5f 73 74 65 70 28 29 20 72 65 74 lite3_step() ret
4420: 75 72 6e 65 64 20 73 6f 6d 65 74 68 69 6e 67 20 urned something
4430: 6f 74 68 65 72 20 74 68 61 6e 20 61 20 53 51 4c other than a SQL
4440: 49 54 45 5f 4c 4f 43 4b 45 44 0a 20 20 20 20 2a ITE_LOCKED. *
4450: 2a 20 6f 72 20 53 51 4c 49 54 45 5f 42 55 53 59 * or SQLITE_BUSY
4460: 20 65 72 72 6f 72 2e 0a 20 20 20 20 2a 2f 0a 23 error.. */.#
4470: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 ifdef SQLITE_OMI
4480: 54 5f 41 55 54 4f 52 45 53 45 54 0a 20 20 20 20 T_AUTORESET.
4490: 69 66 28 20 28 72 63 20 3d 20 70 2d 3e 72 63 26 if( (rc = p->rc&
44a0: 30 78 66 66 29 3d 3d 53 51 4c 49 54 45 5f 42 55 0xff)==SQLITE_BU
44b0: 53 59 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 SY || rc==SQLITE
44c0: 5f 4c 4f 43 4b 45 44 20 29 7b 0a 20 20 20 20 20 _LOCKED ){.
44d0: 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 28 sqlite3_reset((
44e0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 sqlite3_stmt*)p)
44f0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
4500: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
4510: 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
4520: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 73 71 }.#else. sq
4530: 6c 69 74 65 33 5f 72 65 73 65 74 28 28 73 71 6c lite3_reset((sql
4540: 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 3b 0a 23 ite3_stmt*)p);.#
4550: 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 endif. }.. /*
4560: 43 68 65 63 6b 20 74 68 61 74 20 6d 61 6c 6c 6f Check that mallo
4570: 63 28 29 20 68 61 73 20 6e 6f 74 20 66 61 69 6c c() has not fail
4580: 65 64 2e 20 49 66 20 69 74 20 68 61 73 2c 20 72 ed. If it has, r
4590: 65 74 75 72 6e 20 65 61 72 6c 79 2e 20 2a 2f 0a eturn early. */.
45a0: 20 20 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 db = p->db;.
45b0: 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 if( db->mallocFa
45c0: 69 6c 65 64 20 29 7b 0a 20 20 20 20 70 2d 3e 72 iled ){. p->r
45d0: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
45e0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
45f0: 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a ITE_NOMEM_BKPT;.
4600: 20 20 7d 0a 0a 20 20 69 66 28 20 70 2d 3e 70 63 }.. if( p->pc
4610: 3c 3d 30 20 26 26 20 70 2d 3e 65 78 70 69 72 65 <=0 && p->expire
4620: 64 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d d ){. p->rc =
4630: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a SQLITE_SCHEMA;.
4640: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
4650: 45 52 52 4f 52 3b 0a 20 20 20 20 67 6f 74 6f 20 ERROR;. goto
4660: 65 6e 64 5f 6f 66 5f 73 74 65 70 3b 0a 20 20 7d end_of_step;. }
4670: 0a 20 20 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 . if( p->pc<0 )
4680: 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 {. /* If ther
4690: 65 20 61 72 65 20 6e 6f 20 6f 74 68 65 72 20 73 e are no other s
46a0: 74 61 74 65 6d 65 6e 74 73 20 63 75 72 72 65 6e tatements curren
46b0: 74 6c 79 20 72 75 6e 6e 69 6e 67 2c 20 74 68 65 tly running, the
46c0: 6e 0a 20 20 20 20 2a 2a 20 72 65 73 65 74 20 74 n. ** reset t
46d0: 68 65 20 69 6e 74 65 72 72 75 70 74 20 66 6c 61 he interrupt fla
46e0: 67 2e 20 20 54 68 69 73 20 70 72 65 76 65 6e 74 g. This prevent
46f0: 73 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 s a call to sqli
4700: 74 65 33 5f 69 6e 74 65 72 72 75 70 74 0a 20 20 te3_interrupt.
4710: 20 20 2a 2a 20 66 72 6f 6d 20 69 6e 74 65 72 72 ** from interr
4720: 75 70 74 69 6e 67 20 61 20 73 74 61 74 65 6d 65 upting a stateme
4730: 6e 74 20 74 68 61 74 20 68 61 73 20 6e 6f 74 20 nt that has not
4740: 79 65 74 20 73 74 61 72 74 65 64 2e 0a 20 20 20 yet started..
4750: 20 2a 2f 0a 20 20 20 20 69 66 28 20 64 62 2d 3e */. if( db->
4760: 6e 56 64 62 65 41 63 74 69 76 65 3d 3d 30 20 29 nVdbeActive==0 )
4770: 7b 0a 20 20 20 20 20 20 64 62 2d 3e 75 31 2e 69 {. db->u1.i
4780: 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d 20 30 sInterrupted = 0
4790: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 73 73 ;. }.. ass
47a0: 65 72 74 28 20 64 62 2d 3e 6e 56 64 62 65 57 72 ert( db->nVdbeWr
47b0: 69 74 65 3e 30 20 7c 7c 20 64 62 2d 3e 61 75 74 ite>0 || db->aut
47c0: 6f 43 6f 6d 6d 69 74 3d 3d 30 20 0a 20 20 20 20 oCommit==0 .
47d0: 20 20 20 20 7c 7c 20 28 64 62 2d 3e 6e 44 65 66 || (db->nDef
47e0: 65 72 72 65 64 43 6f 6e 73 3d 3d 30 20 26 26 20 erredCons==0 &&
47f0: 64 62 2d 3e 6e 44 65 66 65 72 72 65 64 49 6d 6d db->nDeferredImm
4800: 43 6f 6e 73 3d 3d 30 29 0a 20 20 20 20 29 3b 0a Cons==0). );.
4810: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
4820: 4f 4d 49 54 5f 54 52 41 43 45 0a 20 20 20 20 69 OMIT_TRACE. i
4830: 66 28 20 28 64 62 2d 3e 78 50 72 6f 66 69 6c 65 f( (db->xProfile
4840: 20 7c 7c 20 28 64 62 2d 3e 6d 54 72 61 63 65 20 || (db->mTrace
4850: 26 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 50 & SQLITE_TRACE_P
4860: 52 4f 46 49 4c 45 29 21 3d 30 29 0a 20 20 20 20 ROFILE)!=0).
4870: 20 20 20 20 26 26 20 21 64 62 2d 3e 69 6e 69 74 && !db->init
4880: 2e 62 75 73 79 20 26 26 20 70 2d 3e 7a 53 71 6c .busy && p->zSql
4890: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
48a0: 33 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 49 6e 3OsCurrentTimeIn
48b0: 74 36 34 28 64 62 2d 3e 70 56 66 73 2c 20 26 70 t64(db->pVfs, &p
48c0: 2d 3e 73 74 61 72 74 54 69 6d 65 29 3b 0a 20 20 ->startTime);.
48d0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 }else{. a
48e0: 73 73 65 72 74 28 20 70 2d 3e 73 74 61 72 74 54 ssert( p->startT
48f0: 69 6d 65 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a ime==0 );. }.
4900: 23 65 6e 64 69 66 0a 0a 20 20 20 20 64 62 2d 3e #endif.. db->
4910: 6e 56 64 62 65 41 63 74 69 76 65 2b 2b 3b 0a 20 nVdbeActive++;.
4920: 20 20 20 69 66 28 20 70 2d 3e 72 65 61 64 4f 6e if( p->readOn
4930: 6c 79 3d 3d 30 20 29 20 64 62 2d 3e 6e 56 64 62 ly==0 ) db->nVdb
4940: 65 57 72 69 74 65 2b 2b 3b 0a 20 20 20 20 69 66 eWrite++;. if
4950: 28 20 70 2d 3e 62 49 73 52 65 61 64 65 72 20 29 ( p->bIsReader )
4960: 20 64 62 2d 3e 6e 56 64 62 65 52 65 61 64 2b 2b db->nVdbeRead++
4970: 3b 0a 20 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b ;. p->pc = 0;
4980: 0a 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 . }.#ifdef SQLI
4990: 54 45 5f 44 45 42 55 47 0a 20 20 70 2d 3e 72 63 TE_DEBUG. p->rc
49a0: 41 70 70 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b App = SQLITE_OK;
49b0: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
49c0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c SQLITE_OMIT_EXPL
49d0: 41 49 4e 0a 20 20 69 66 28 20 70 2d 3e 65 78 70 AIN. if( p->exp
49e0: 6c 61 69 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d lain ){. rc =
49f0: 20 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74 sqlite3VdbeList
4a00: 28 70 29 3b 0a 20 20 7d 65 6c 73 65 0a 23 65 6e (p);. }else.#en
4a10: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
4a20: 49 54 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 20 20 IT_EXPLAIN */.
4a30: 7b 0a 20 20 20 20 64 62 2d 3e 6e 56 64 62 65 45 {. db->nVdbeE
4a40: 78 65 63 2b 2b 3b 0a 20 20 20 20 72 63 20 3d 20 xec++;. rc =
4a50: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 sqlite3VdbeExec(
4a60: 70 29 3b 0a 20 20 20 20 64 62 2d 3e 6e 56 64 62 p);. db->nVdb
4a70: 65 45 78 65 63 2d 2d 3b 0a 20 20 7d 0a 0a 23 69 eExec--;. }..#i
4a80: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
4a90: 54 5f 54 52 41 43 45 0a 20 20 2f 2a 20 49 66 20 T_TRACE. /* If
4aa0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 63 6f the statement co
4ab0: 6d 70 6c 65 74 65 64 20 73 75 63 63 65 73 73 66 mpleted successf
4ac0: 75 6c 6c 79 2c 20 69 6e 76 6f 6b 65 20 74 68 65 ully, invoke the
4ad0: 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62 61 63 profile callbac
4ae0: 6b 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d 53 k */. if( rc!=S
4af0: 51 4c 49 54 45 5f 52 4f 57 20 29 20 63 68 65 63 QLITE_ROW ) chec
4b00: 6b 50 72 6f 66 69 6c 65 43 61 6c 6c 62 61 63 6b kProfileCallback
4b10: 28 64 62 2c 20 70 29 3b 0a 23 65 6e 64 69 66 0a (db, p);.#endif.
4b20: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
4b30: 45 5f 44 4f 4e 45 20 26 26 20 64 62 2d 3e 61 75 E_DONE && db->au
4b40: 74 6f 43 6f 6d 6d 69 74 20 29 7b 0a 20 20 20 20 toCommit ){.
4b50: 61 73 73 65 72 74 28 20 70 2d 3e 72 63 3d 3d 53 assert( p->rc==S
4b60: 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 QLITE_OK );.
4b70: 70 2d 3e 72 63 20 3d 20 64 6f 57 61 6c 43 61 6c p->rc = doWalCal
4b80: 6c 62 61 63 6b 73 28 64 62 29 3b 0a 20 20 20 20 lbacks(db);.
4b90: 69 66 28 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54 if( p->rc!=SQLIT
4ba0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 E_OK ){. rc
4bb0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
4bc0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 64 62 . }. }.. db
4bd0: 2d 3e 65 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a ->errCode = rc;.
4be0: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4e 4f 4d if( SQLITE_NOM
4bf0: 45 4d 3d 3d 73 71 6c 69 74 65 33 41 70 69 45 78 EM==sqlite3ApiEx
4c00: 69 74 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 29 it(p->db, p->rc)
4c10: 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 ){. p->rc =
4c20: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
4c30: 54 3b 0a 20 20 7d 0a 65 6e 64 5f 6f 66 5f 73 74 T;. }.end_of_st
4c40: 65 70 3a 0a 20 20 2f 2a 20 41 74 20 74 68 69 73 ep:. /* At this
4c50: 20 70 6f 69 6e 74 20 6c 6f 63 61 6c 20 76 61 72 point local var
4c60: 69 61 62 6c 65 20 72 63 20 68 6f 6c 64 73 20 74 iable rc holds t
4c70: 68 65 20 76 61 6c 75 65 20 74 68 61 74 20 73 68 he value that sh
4c80: 6f 75 6c 64 20 62 65 20 0a 20 20 2a 2a 20 72 65 ould be . ** re
4c90: 74 75 72 6e 65 64 20 69 66 20 74 68 69 73 20 73 turned if this s
4ca0: 74 61 74 65 6d 65 6e 74 20 77 61 73 20 63 6f 6d tatement was com
4cb0: 70 69 6c 65 64 20 75 73 69 6e 67 20 74 68 65 20 piled using the
4cc0: 6c 65 67 61 63 79 20 0a 20 20 2a 2a 20 73 71 6c legacy . ** sql
4cd0: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 69 ite3_prepare() i
4ce0: 6e 74 65 72 66 61 63 65 2e 20 41 63 63 6f 72 64 nterface. Accord
4cf0: 69 6e 67 20 74 6f 20 74 68 65 20 64 6f 63 73 2c ing to the docs,
4d00: 20 74 68 69 73 20 63 61 6e 20 6f 6e 6c 79 0a 20 this can only.
4d10: 20 2a 2a 20 62 65 20 6f 6e 65 20 6f 66 20 74 68 ** be one of th
4d20: 65 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 e values in the
4d30: 66 69 72 73 74 20 61 73 73 65 72 74 28 29 20 62 first assert() b
4d40: 65 6c 6f 77 2e 20 56 61 72 69 61 62 6c 65 20 70 elow. Variable p
4d50: 2d 3e 72 63 20 0a 20 20 2a 2a 20 63 6f 6e 74 61 ->rc . ** conta
4d60: 69 6e 73 20 74 68 65 20 76 61 6c 75 65 20 74 68 ins the value th
4d70: 61 74 20 77 6f 75 6c 64 20 62 65 20 72 65 74 75 at would be retu
4d80: 72 6e 65 64 20 69 66 20 73 71 6c 69 74 65 33 5f rned if sqlite3_
4d90: 66 69 6e 61 6c 69 7a 65 28 29 20 0a 20 20 2a 2a finalize() . **
4da0: 20 77 65 72 65 20 63 61 6c 6c 65 64 20 6f 6e 20 were called on
4db0: 73 74 61 74 65 6d 65 6e 74 20 70 2e 0a 20 20 2a statement p.. *
4dc0: 2f 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d /. assert( rc==
4dd0: 53 51 4c 49 54 45 5f 52 4f 57 20 20 7c 7c 20 72 SQLITE_ROW || r
4de0: 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 20 c==SQLITE_DONE
4df0: 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45 || rc==SQLITE_E
4e00: 52 52 4f 52 20 0a 20 20 20 20 20 20 20 7c 7c 20 RROR . ||
4e10: 28 72 63 26 30 78 66 66 29 3d 3d 53 51 4c 49 54 (rc&0xff)==SQLIT
4e20: 45 5f 42 55 53 59 20 7c 7c 20 72 63 3d 3d 53 51 E_BUSY || rc==SQ
4e30: 4c 49 54 45 5f 4d 49 53 55 53 45 0a 20 20 29 3b LITE_MISUSE. );
4e40: 0a 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e 72 . assert( (p->r
4e50: 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 26 c!=SQLITE_ROW &&
4e60: 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54 45 5f 44 p->rc!=SQLITE_D
4e70: 4f 4e 45 29 20 7c 7c 20 70 2d 3e 72 63 3d 3d 70 ONE) || p->rc==p
4e80: 2d 3e 72 63 41 70 70 20 29 3b 0a 20 20 69 66 28 ->rcApp );. if(
4e90: 20 28 70 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 (p->prepFlags &
4ea0: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f SQLITE_PREPARE_
4eb0: 53 41 56 45 53 51 4c 29 21 3d 30 20 0a 20 20 20 SAVESQL)!=0 .
4ec0: 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 52 4f && rc!=SQLITE_RO
4ed0: 57 20 0a 20 20 20 26 26 20 72 63 21 3d 53 51 4c W . && rc!=SQL
4ee0: 49 54 45 5f 44 4f 4e 45 20 0a 20 20 29 7b 0a 20 ITE_DONE . ){.
4ef0: 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 73 74 /* If this st
4f00: 61 74 65 6d 65 6e 74 20 77 61 73 20 70 72 65 70 atement was prep
4f10: 61 72 65 64 20 75 73 69 6e 67 20 73 61 76 65 64 ared using saved
4f20: 20 53 51 4c 20 61 6e 64 20 61 6e 20 0a 20 20 20 SQL and an .
4f30: 20 2a 2a 20 65 72 72 6f 72 20 68 61 73 20 6f 63 ** error has oc
4f40: 63 75 72 72 65 64 2c 20 74 68 65 6e 20 72 65 74 curred, then ret
4f50: 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 63 6f urn the error co
4f60: 64 65 20 69 6e 20 70 2d 3e 72 63 20 74 6f 20 74 de in p->rc to t
4f70: 68 65 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 65 72 he. ** caller
4f80: 2e 20 53 65 74 20 74 68 65 20 65 72 72 6f 72 20 . Set the error
4f90: 63 6f 64 65 20 69 6e 20 74 68 65 20 64 61 74 61 code in the data
4fa0: 62 61 73 65 20 68 61 6e 64 6c 65 20 74 6f 20 74 base handle to t
4fb0: 68 65 20 73 61 6d 65 20 76 61 6c 75 65 2e 0a 20 he same value..
4fc0: 20 20 20 2a 2f 20 0a 20 20 20 20 72 63 20 3d 20 */ . rc =
4fd0: 73 71 6c 69 74 65 33 56 64 62 65 54 72 61 6e 73 sqlite3VdbeTrans
4fe0: 66 65 72 45 72 72 6f 72 28 70 29 3b 0a 20 20 7d ferError(p);. }
4ff0: 0a 20 20 72 65 74 75 72 6e 20 28 72 63 26 64 62 . return (rc&db
5000: 2d 3e 65 72 72 4d 61 73 6b 29 3b 0a 7d 0a 0a 2f ->errMask);.}../
5010: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 *.** This is the
5020: 20 74 6f 70 2d 6c 65 76 65 6c 20 69 6d 70 6c 65 top-level imple
5030: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73 71 6c mentation of sql
5040: 69 74 65 33 5f 73 74 65 70 28 29 2e 20 20 43 61 ite3_step(). Ca
5050: 6c 6c 0a 2a 2a 20 73 71 6c 69 74 65 33 53 74 65 ll.** sqlite3Ste
5060: 70 28 29 20 74 6f 20 64 6f 20 6d 6f 73 74 20 6f p() to do most o
5070: 66 20 74 68 65 20 77 6f 72 6b 2e 20 20 49 66 20 f the work. If
5080: 61 20 73 63 68 65 6d 61 20 65 72 72 6f 72 20 6f a schema error o
5090: 63 63 75 72 73 2c 0a 2a 2a 20 63 61 6c 6c 20 73 ccurs,.** call s
50a0: 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 28 qlite3Reprepare(
50b0: 29 20 61 6e 64 20 74 72 79 20 61 67 61 69 6e 2e ) and try again.
50c0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
50d0: 73 74 65 70 28 73 71 6c 69 74 65 33 5f 73 74 6d step(sqlite3_stm
50e0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69 6e 74 t *pStmt){. int
50f0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
5100: 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
5110: 66 72 6f 6d 20 73 71 6c 69 74 65 33 53 74 65 70 from sqlite3Step
5120: 28 29 20 2a 2f 0a 20 20 69 6e 74 20 72 63 32 20 () */. int rc2
5130: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
5140: 20 2f 2a 20 52 65 73 75 6c 74 20 66 72 6f 6d 20 /* Result from
5150: 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 sqlite3Reprepare
5160: 28 29 20 2a 2f 0a 20 20 56 64 62 65 20 2a 76 20 () */. Vdbe *v
5170: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 20 = (Vdbe*)pStmt;
5180: 20 2f 2a 20 74 68 65 20 70 72 65 70 61 72 65 64 /* the prepared
5190: 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 statement */.
51a0: 69 6e 74 20 63 6e 74 20 3d 20 30 3b 20 20 20 20 int cnt = 0;
51b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e /* Coun
51c0: 74 65 72 20 74 6f 20 70 72 65 76 65 6e 74 20 69 ter to prevent i
51d0: 6e 66 69 6e 69 74 65 20 6c 6f 6f 70 20 6f 66 20 nfinite loop of
51e0: 72 65 70 72 65 70 61 72 65 73 20 2a 2f 0a 20 20 reprepares */.
51f0: 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 sqlite3 *db;
5200: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
5210: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
5220: 69 6f 6e 20 2a 2f 0a 0a 20 20 69 66 28 20 76 64 ion */.. if( vd
5230: 62 65 53 61 66 65 74 79 4e 6f 74 4e 75 6c 6c 28 beSafetyNotNull(
5240: 76 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e v) ){. return
5250: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
5260: 4b 50 54 3b 0a 20 20 7d 0a 20 20 64 62 20 3d 20 KPT;. }. db =
5270: 76 2d 3e 64 62 3b 0a 20 20 73 71 6c 69 74 65 33 v->db;. sqlite3
5280: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
5290: 3e 6d 75 74 65 78 29 3b 0a 20 20 76 2d 3e 64 6f >mutex);. v->do
52a0: 69 6e 67 52 65 72 75 6e 20 3d 20 30 3b 0a 20 20 ingRerun = 0;.
52b0: 77 68 69 6c 65 28 20 28 72 63 20 3d 20 73 71 6c while( (rc = sql
52c0: 69 74 65 33 53 74 65 70 28 76 29 29 3d 3d 53 51 ite3Step(v))==SQ
52d0: 4c 49 54 45 5f 53 43 48 45 4d 41 0a 20 20 20 20 LITE_SCHEMA.
52e0: 20 20 20 20 20 26 26 20 63 6e 74 2b 2b 20 3c 20 && cnt++ <
52f0: 53 51 4c 49 54 45 5f 4d 41 58 5f 53 43 48 45 4d SQLITE_MAX_SCHEM
5300: 41 5f 52 45 54 52 59 20 29 7b 0a 20 20 20 20 69 A_RETRY ){. i
5310: 6e 74 20 73 61 76 65 64 50 63 20 3d 20 76 2d 3e nt savedPc = v->
5320: 70 63 3b 0a 20 20 20 20 72 63 32 20 3d 20 72 63 pc;. rc2 = rc
5330: 20 3d 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 = sqlite3Reprep
5340: 61 72 65 28 76 29 3b 0a 20 20 20 20 69 66 28 20 are(v);. if(
5350: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 62 rc!=SQLITE_OK) b
5360: 72 65 61 6b 3b 0a 20 20 20 20 73 71 6c 69 74 65 reak;. sqlite
5370: 33 5f 72 65 73 65 74 28 70 53 74 6d 74 29 3b 0a 3_reset(pStmt);.
5380: 20 20 20 20 69 66 28 20 73 61 76 65 64 50 63 3e if( savedPc>
5390: 3d 30 20 29 20 76 2d 3e 64 6f 69 6e 67 52 65 72 =0 ) v->doingRer
53a0: 75 6e 20 3d 20 31 3b 0a 20 20 20 20 61 73 73 65 un = 1;. asse
53b0: 72 74 28 20 76 2d 3e 65 78 70 69 72 65 64 3d 3d rt( v->expired==
53c0: 30 20 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 0 );. }. if( r
53d0: 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b c2!=SQLITE_OK ){
53e0: 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61 73 . /* This cas
53f0: 65 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 66 e occurs after f
5400: 61 69 6c 69 6e 67 20 74 6f 20 72 65 63 6f 6d 70 ailing to recomp
5410: 69 6c 65 20 61 6e 20 73 71 6c 20 73 74 61 74 65 ile an sql state
5420: 6d 65 6e 74 2e 20 0a 20 20 20 20 2a 2a 20 54 68 ment. . ** Th
5430: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 e error message
5440: 66 72 6f 6d 20 74 68 65 20 53 51 4c 20 63 6f 6d from the SQL com
5450: 70 69 6c 65 72 20 68 61 73 20 61 6c 72 65 61 64 piler has alread
5460: 79 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 0a 20 y been loaded .
5470: 20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 20 64 ** into the d
5480: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 atabase handle.
5490: 54 68 69 73 20 62 6c 6f 63 6b 20 63 6f 70 69 65 This block copie
54a0: 73 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 s the error mess
54b0: 61 67 65 20 0a 20 20 20 20 2a 2a 20 66 72 6f 6d age . ** from
54c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
54d0: 6e 64 6c 65 20 69 6e 74 6f 20 74 68 65 20 73 74 ndle into the st
54e0: 61 74 65 6d 65 6e 74 20 61 6e 64 20 73 65 74 73 atement and sets
54f0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 0a 20 the statement.
5500: 20 20 20 2a 2a 20 70 72 6f 67 72 61 6d 20 63 6f ** program co
5510: 75 6e 74 65 72 20 74 6f 20 30 20 74 6f 20 65 6e unter to 0 to en
5520: 73 75 72 65 20 74 68 61 74 20 77 68 65 6e 20 74 sure that when t
5530: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 he statement is
5540: 0a 20 20 20 20 2a 2a 20 66 69 6e 61 6c 69 7a 65 . ** finalize
5550: 64 20 6f 72 20 72 65 73 65 74 20 74 68 65 20 70 d or reset the p
5560: 61 72 73 65 72 20 65 72 72 6f 72 20 6d 65 73 73 arser error mess
5570: 61 67 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65 age is available
5580: 20 76 69 61 0a 20 20 20 20 2a 2a 20 73 71 6c 69 via. ** sqli
5590: 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 te3_errmsg() and
55a0: 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 sqlite3_errcode
55b0: 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 ().. */. c
55c0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 72 72 20 onst char *zErr
55d0: 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 = (const char *)
55e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 sqlite3_value_te
55f0: 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 20 0a 20 xt(db->pErr); .
5600: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 sqlite3DbFree
5610: 28 64 62 2c 20 76 2d 3e 7a 45 72 72 4d 73 67 29 (db, v->zErrMsg)
5620: 3b 0a 20 20 20 20 69 66 28 20 21 64 62 2d 3e 6d ;. if( !db->m
5630: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
5640: 20 20 20 20 20 76 2d 3e 7a 45 72 72 4d 73 67 20 v->zErrMsg
5650: 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 75 = sqlite3DbStrDu
5660: 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20 20 20 p(db, zErr);.
5670: 20 20 20 76 2d 3e 72 63 20 3d 20 72 63 32 3b 0a v->rc = rc2;.
5680: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 } else {.
5690: 20 20 20 76 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 v->zErrMsg =
56a0: 30 3b 0a 20 20 20 20 20 20 76 2d 3e 72 63 20 3d 0;. v->rc =
56b0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
56c0: 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 EM_BKPT;. }.
56d0: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
56e0: 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3ApiExit(db, rc)
56f0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
5700: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
5710: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b x);. return rc;
5720: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 .}.../*.** Extra
5730: 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74 61 ct the user data
5740: 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 5f from a sqlite3_
5750: 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 context structur
5760: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a 2a e and return a.*
5770: 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e * pointer to it.
5780: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
5790: 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c 69 3_user_data(sqli
57a0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b te3_context *p){
57b0: 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 . assert( p &&
57c0: 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 65 p->pFunc );. re
57d0: 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e 70 turn p->pFunc->p
57e0: 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a UserData;.}../*.
57f0: 2a 2a 20 45 78 74 72 61 63 74 20 74 68 65 20 75 ** Extract the u
5800: 73 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 ser data from a
5810: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
5820: 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 72 65 structure and re
5830: 74 75 72 6e 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 turn a.** pointe
5840: 72 20 74 6f 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 r to it..**.** I
5850: 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 MPLEMENTATION-OF
5860: 3a 20 52 2d 34 36 37 39 38 2d 35 30 33 30 31 20 : R-46798-50301
5870: 54 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 The sqlite3_cont
5880: 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 29 20 ext_db_handle()
5890: 69 6e 74 65 72 66 61 63 65 0a 2a 2a 20 72 65 74 interface.** ret
58a0: 75 72 6e 73 20 61 20 63 6f 70 79 20 6f 66 20 74 urns a copy of t
58b0: 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 he pointer to th
58c0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
58d0: 63 74 69 6f 6e 20 28 74 68 65 20 31 73 74 0a 2a ction (the 1st.*
58e0: 2a 20 70 61 72 61 6d 65 74 65 72 29 20 6f 66 20 * parameter) of
58f0: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 72 65 61 the sqlite3_crea
5900: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 20 61 6e te_function() an
5910: 64 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 72 65 d.** sqlite3_cre
5920: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 31 36 28 29 ate_function16()
5930: 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 20 6f routines that o
5940: 72 69 67 69 6e 61 6c 6c 79 20 72 65 67 69 73 74 riginally regist
5950: 65 72 65 64 20 74 68 65 0a 2a 2a 20 61 70 70 6c ered the.** appl
5960: 69 63 61 74 69 6f 6e 20 64 65 66 69 6e 65 64 20 ication defined
5970: 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c function..*/.sql
5980: 69 74 65 33 20 2a 73 71 6c 69 74 65 33 5f 63 6f ite3 *sqlite3_co
5990: 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64 6c 65 28 ntext_db_handle(
59a0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
59b0: 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 *p){. assert( p
59c0: 20 26 26 20 70 2d 3e 70 4f 75 74 20 29 3b 0a 20 && p->pOut );.
59d0: 20 72 65 74 75 72 6e 20 70 2d 3e 70 4f 75 74 2d return p->pOut-
59e0: 3e 64 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 >db;.}../*.** Re
59f0: 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 turn the current
5a00: 20 74 69 6d 65 20 66 6f 72 20 61 20 73 74 61 74 time for a stat
5a10: 65 6d 65 6e 74 2e 20 20 49 66 20 74 68 65 20 63 ement. If the c
5a20: 75 72 72 65 6e 74 20 74 69 6d 65 0a 2a 2a 20 69 urrent time.** i
5a30: 73 20 72 65 71 75 65 73 74 65 64 20 6d 6f 72 65 s requested more
5a40: 20 74 68 61 6e 20 6f 6e 63 65 20 77 69 74 68 69 than once withi
5a50: 6e 20 74 68 65 20 73 61 6d 65 20 72 75 6e 20 6f n the same run o
5a60: 66 20 61 20 73 69 6e 67 6c 65 20 70 72 65 70 61 f a single prepa
5a70: 72 65 64 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 red.** statement
5a80: 2c 20 74 68 65 20 65 78 61 63 74 20 73 61 6d 65 , the exact same
5a90: 20 74 69 6d 65 20 69 73 20 72 65 74 75 72 6e 65 time is returne
5aa0: 64 20 66 6f 72 20 65 61 63 68 20 69 6e 76 6f 63 d for each invoc
5ab0: 61 74 69 6f 6e 20 72 65 67 61 72 64 6c 65 73 73 ation regardless
5ac0: 0a 2a 2a 20 6f 66 20 74 68 65 20 61 6d 6f 75 6e .** of the amoun
5ad0: 74 20 6f 66 20 74 69 6d 65 20 74 68 61 74 20 65 t of time that e
5ae0: 6c 61 70 73 65 73 20 62 65 74 77 65 65 6e 20 69 lapses between i
5af0: 6e 76 6f 63 61 74 69 6f 6e 73 2e 20 20 49 6e 20 nvocations. In
5b00: 6f 74 68 65 72 20 77 6f 72 64 73 2c 0a 2a 2a 20 other words,.**
5b10: 74 68 65 20 74 69 6d 65 20 72 65 74 75 72 6e 65 the time returne
5b20: 64 20 69 73 20 61 6c 77 61 79 73 20 74 68 65 20 d is always the
5b30: 74 69 6d 65 20 6f 66 20 74 68 65 20 66 69 72 73 time of the firs
5b40: 74 20 63 61 6c 6c 2e 0a 2a 2f 0a 73 71 6c 69 74 t call..*/.sqlit
5b50: 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 e3_int64 sqlite3
5b60: 53 74 6d 74 43 75 72 72 65 6e 74 54 69 6d 65 28 StmtCurrentTime(
5b70: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 sqlite3_context
5b80: 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 23 *p){. int rc;.#
5b90: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e ifndef SQLITE_EN
5ba0: 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 ABLE_STAT3_OR_ST
5bb0: 41 54 34 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e AT4. sqlite3_in
5bc0: 74 36 34 20 2a 70 69 54 69 6d 65 20 3d 20 26 70 t64 *piTime = &p
5bd0: 2d 3e 70 56 64 62 65 2d 3e 69 43 75 72 72 65 6e ->pVdbe->iCurren
5be0: 74 54 69 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 tTime;. assert(
5bf0: 20 70 2d 3e 70 56 64 62 65 21 3d 30 20 29 3b 0a p->pVdbe!=0 );.
5c00: 23 65 6c 73 65 0a 20 20 73 71 6c 69 74 65 33 5f #else. sqlite3_
5c10: 69 6e 74 36 34 20 69 54 69 6d 65 20 3d 20 30 3b int64 iTime = 0;
5c20: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 . sqlite3_int64
5c30: 20 2a 70 69 54 69 6d 65 20 3d 20 70 2d 3e 70 56 *piTime = p->pV
5c40: 64 62 65 21 3d 30 20 3f 20 26 70 2d 3e 70 56 64 dbe!=0 ? &p->pVd
5c50: 62 65 2d 3e 69 43 75 72 72 65 6e 74 54 69 6d 65 be->iCurrentTime
5c60: 20 3a 20 26 69 54 69 6d 65 3b 0a 23 65 6e 64 69 : &iTime;.#endi
5c70: 66 0a 20 20 69 66 28 20 2a 70 69 54 69 6d 65 3d f. if( *piTime=
5c80: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 =0 ){. rc = s
5c90: 71 6c 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 qlite3OsCurrentT
5ca0: 69 6d 65 49 6e 74 36 34 28 70 2d 3e 70 4f 75 74 imeInt64(p->pOut
5cb0: 2d 3e 64 62 2d 3e 70 56 66 73 2c 20 70 69 54 69 ->db->pVfs, piTi
5cc0: 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 me);. if( rc
5cd0: 29 20 2a 70 69 54 69 6d 65 20 3d 20 30 3b 0a 20 ) *piTime = 0;.
5ce0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 2a 70 69 54 }. return *piT
5cf0: 69 6d 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 ime;.}../*.** Th
5d00: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 e following is t
5d10: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f he implementatio
5d20: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 66 75 6e 63 n of an SQL func
5d30: 74 69 6f 6e 20 74 68 61 74 20 61 6c 77 61 79 73 tion that always
5d40: 0a 2a 2a 20 66 61 69 6c 73 20 77 69 74 68 20 61 .** fails with a
5d50: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 n error message
5d60: 73 74 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 stating that the
5d70: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
5d80: 64 20 69 6e 20 74 68 65 0a 2a 2a 20 77 72 6f 6e d in the.** wron
5d90: 67 20 63 6f 6e 74 65 78 74 2e 20 20 54 68 65 20 g context. The
5da0: 73 71 6c 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 sqlite3_overload
5db0: 5f 66 75 6e 63 74 69 6f 6e 28 29 20 41 50 49 20 _function() API
5dc0: 6d 69 67 68 74 20 63 6f 6e 73 74 72 75 63 74 0a might construct.
5dd0: 2a 2a 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 ** SQL function
5de0: 74 68 61 74 20 75 73 65 20 74 68 69 73 20 72 6f that use this ro
5df0: 75 74 69 6e 65 20 73 6f 20 74 68 61 74 20 74 68 utine so that th
5e00: 65 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c e functions will
5e10: 20 65 78 69 73 74 0a 2a 2a 20 66 6f 72 20 6e 61 exist.** for na
5e20: 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 62 75 me resolution bu
5e30: 74 20 61 72 65 20 61 63 74 75 61 6c 6c 79 20 6f t are actually o
5e40: 76 65 72 6c 6f 61 64 65 64 20 62 79 20 74 68 65 verloaded by the
5e50: 20 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 0a 2a xFindFunction.*
5e60: 2a 20 6d 65 74 68 6f 64 20 6f 66 20 76 69 72 74 * method of virt
5e70: 75 61 6c 20 74 61 62 6c 65 73 2e 0a 2a 2f 0a 76 ual tables..*/.v
5e80: 6f 69 64 20 73 71 6c 69 74 65 33 49 6e 76 61 6c oid sqlite3Inval
5e90: 69 64 46 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 idFunction(. sq
5ea0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 63 lite3_context *c
5eb0: 6f 6e 74 65 78 74 2c 20 20 2f 2a 20 54 68 65 20 ontext, /* The
5ec0: 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 69 6e 67 function calling
5ed0: 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e context */. in
5ee0: 74 20 4e 6f 74 55 73 65 64 2c 20 20 20 20 20 20 t NotUsed,
5ef0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
5f00: 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 er of arguments
5f10: 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 to the function
5f20: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c */. sqlite3_val
5f30: 75 65 20 2a 2a 4e 6f 74 55 73 65 64 32 20 20 20 ue **NotUsed2
5f40: 2f 2a 20 56 61 6c 75 65 20 6f 66 20 65 61 63 68 /* Value of each
5f50: 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 29 7b 0a argument */.){.
5f60: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e const char *zN
5f70: 61 6d 65 20 3d 20 63 6f 6e 74 65 78 74 2d 3e 70 ame = context->p
5f80: 46 75 6e 63 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 63 Func->zName;. c
5f90: 68 61 72 20 2a 7a 45 72 72 3b 0a 20 20 55 4e 55 har *zErr;. UNU
5fa0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 4e SED_PARAMETER2(N
5fb0: 6f 74 55 73 65 64 2c 20 4e 6f 74 55 73 65 64 32 otUsed, NotUsed2
5fc0: 29 3b 0a 20 20 7a 45 72 72 20 3d 20 73 71 6c 69 );. zErr = sqli
5fd0: 74 65 33 5f 6d 70 72 69 6e 74 66 28 0a 20 20 20 te3_mprintf(.
5fe0: 20 20 20 22 75 6e 61 62 6c 65 20 74 6f 20 75 73 "unable to us
5ff0: 65 20 66 75 6e 63 74 69 6f 6e 20 25 73 20 69 6e e function %s in
6000: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 63 the requested c
6010: 6f 6e 74 65 78 74 22 2c 20 7a 4e 61 6d 65 29 3b ontext", zName);
6020: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c . sqlite3_resul
6030: 74 5f 65 72 72 6f 72 28 63 6f 6e 74 65 78 74 2c t_error(context,
6040: 20 7a 45 72 72 2c 20 2d 31 29 3b 0a 20 20 73 71 zErr, -1);. sq
6050: 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72 72 29 lite3_free(zErr)
6060: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 ;.}../*.** Creat
6070: 65 20 61 20 6e 65 77 20 61 67 67 72 65 67 61 74 e a new aggregat
6080: 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 20 70 20 e context for p
6090: 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 and return a poi
60a0: 6e 74 65 72 20 74 6f 0a 2a 2a 20 69 74 73 20 70 nter to.** its p
60b0: 4d 65 6d 2d 3e 7a 20 65 6c 65 6d 65 6e 74 2e 0a Mem->z element..
60c0: 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 */.static SQLITE
60d0: 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 20 2a _NOINLINE void *
60e0: 63 72 65 61 74 65 41 67 67 43 6f 6e 74 65 78 74 createAggContext
60f0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
6100: 20 2a 70 2c 20 69 6e 74 20 6e 42 79 74 65 29 7b *p, int nByte){
6110: 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 70 . Mem *pMem = p
6120: 2d 3e 70 4d 65 6d 3b 0a 20 20 61 73 73 65 72 74 ->pMem;. assert
6130: 28 20 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 ( (pMem->flags &
6140: 20 4d 45 4d 5f 41 67 67 29 3d 3d 30 20 29 3b 0a MEM_Agg)==0 );.
6150: 20 20 69 66 28 20 6e 42 79 74 65 3c 3d 30 20 29 if( nByte<=0 )
6160: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
6170: 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 70 4d 65 6d eMemSetNull(pMem
6180: 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d );. pMem->z =
6190: 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 0;. }else{.
61a0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 sqlite3VdbeMemC
61b0: 6c 65 61 72 41 6e 64 52 65 73 69 7a 65 28 70 4d learAndResize(pM
61c0: 65 6d 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 em, nByte);.
61d0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 pMem->flags = ME
61e0: 4d 5f 41 67 67 3b 0a 20 20 20 20 70 4d 65 6d 2d M_Agg;. pMem-
61f0: 3e 75 2e 70 44 65 66 20 3d 20 70 2d 3e 70 46 75 >u.pDef = p->pFu
6200: 6e 63 3b 0a 20 20 20 20 69 66 28 20 70 4d 65 6d nc;. if( pMem
6210: 2d 3e 7a 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d ->z ){. mem
6220: 73 65 74 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c 20 set(pMem->z, 0,
6230: 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d 0a 20 20 nByte);. }.
6240: 7d 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 }. return (void
6250: 2a 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a *)pMem->z;.}../*
6260: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20 .** Allocate or
6270: 72 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65 return the aggre
6280: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 gate context for
6290: 20 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e a user function
62a0: 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 . A new.** cont
62b0: 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 ext is allocated
62c0: 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61 on the first ca
62d0: 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20 ll. Subsequent
62e0: 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65 calls return the
62f0: 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74 .** same context
6300: 20 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e that was return
6310: 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c ed on prior call
6320: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 s..*/.void *sqli
6330: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f te3_aggregate_co
6340: 6e 74 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f ntext(sqlite3_co
6350: 6e 74 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42 ntext *p, int nB
6360: 79 74 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 yte){. assert(
6370: 70 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26 p && p->pFunc &&
6380: 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 46 69 6e 61 p->pFunc->xFina
6390: 6c 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 74 lize );. assert
63a0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
63b0: 68 65 6c 64 28 70 2d 3e 70 4f 75 74 2d 3e 64 62 held(p->pOut->db
63c0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 74 65 ->mutex) );. te
63d0: 73 74 63 61 73 65 28 20 6e 42 79 74 65 3c 30 20 stcase( nByte<0
63e0: 29 3b 0a 20 20 69 66 28 20 28 70 2d 3e 70 4d 65 );. if( (p->pMe
63f0: 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 m->flags & MEM_A
6400: 67 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 gg)==0 ){. re
6410: 74 75 72 6e 20 63 72 65 61 74 65 41 67 67 43 6f turn createAggCo
6420: 6e 74 65 78 74 28 70 2c 20 6e 42 79 74 65 29 3b ntext(p, nByte);
6430: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 . }else{. re
6440: 74 75 72 6e 20 28 76 6f 69 64 2a 29 70 2d 3e 70 turn (void*)p->p
6450: 4d 65 6d 2d 3e 7a 3b 0a 20 20 7d 0a 7d 0a 0a 2f Mem->z;. }.}../
6460: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
6470: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 20 70 auxiliary data p
6480: 6f 69 6e 74 65 72 2c 20 69 66 20 61 6e 79 2c 20 ointer, if any,
6490: 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 68 20 for the iArg'th
64a0: 61 72 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 argument to.** t
64b0: 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e he user-function
64c0: 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 74 78 defined by pCtx
64d0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 ..**.** The left
64e0: 2d 6d 6f 73 74 20 61 72 67 75 6d 65 6e 74 20 69 -most argument i
64f0: 73 20 30 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64 6f 63 s 0..**.** Undoc
6500: 75 6d 65 6e 74 65 64 20 62 65 68 61 76 69 6f 72 umented behavior
6510: 3a 20 20 49 66 20 69 41 72 67 20 69 73 20 6e 65 : If iArg is ne
6520: 67 61 74 69 76 65 20 74 68 65 6e 20 61 63 63 65 gative then acce
6530: 73 73 20 61 20 63 61 63 68 65 20 6f 66 0a 2a 2a ss a cache of.**
6540: 20 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 20 auxiliary data
6550: 70 6f 69 6e 74 65 72 73 20 74 68 61 74 20 69 73 pointers that is
6560: 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 61 6c available to al
6570: 6c 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 74 68 l functions with
6580: 69 6e 20 61 0a 2a 2a 20 73 69 6e 67 6c 65 20 70 in a.** single p
6590: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e repared statemen
65a0: 74 2e 20 20 54 68 65 20 69 41 72 67 20 76 61 6c t. The iArg val
65b0: 75 65 73 20 6d 75 73 74 20 6d 61 74 63 68 2e 0a ues must match..
65c0: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 */.void *sqlite3
65d0: 5f 67 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c _get_auxdata(sql
65e0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 ite3_context *pC
65f0: 74 78 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 tx, int iArg){.
6600: 20 41 75 78 44 61 74 61 20 2a 70 41 75 78 44 61 AuxData *pAuxDa
6610: 74 61 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 ta;.. assert( s
6620: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
6630: 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 d(pCtx->pOut->db
6640: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 23 69 66 20 ->mutex) );.#if
6650: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
6660: 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 AT3_OR_STAT4. i
6670: 66 28 20 70 43 74 78 2d 3e 70 56 64 62 65 3d 3d f( pCtx->pVdbe==
6680: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 0 ) return 0;.#e
6690: 6c 73 65 0a 20 20 61 73 73 65 72 74 28 20 70 43 lse. assert( pC
66a0: 74 78 2d 3e 70 56 64 62 65 21 3d 30 20 29 3b 0a tx->pVdbe!=0 );.
66b0: 23 65 6e 64 69 66 0a 20 20 66 6f 72 28 70 41 75 #endif. for(pAu
66c0: 78 44 61 74 61 3d 70 43 74 78 2d 3e 70 56 64 62 xData=pCtx->pVdb
66d0: 65 2d 3e 70 41 75 78 44 61 74 61 3b 20 70 41 75 e->pAuxData; pAu
66e0: 78 44 61 74 61 3b 20 70 41 75 78 44 61 74 61 3d xData; pAuxData=
66f0: 70 41 75 78 44 61 74 61 2d 3e 70 4e 65 78 74 41 pAuxData->pNextA
6700: 75 78 29 7b 0a 20 20 20 20 69 66 28 20 20 70 41 ux){. if( pA
6710: 75 78 44 61 74 61 2d 3e 69 41 75 78 41 72 67 3d uxData->iAuxArg=
6720: 3d 69 41 72 67 20 26 26 20 28 70 41 75 78 44 61 =iArg && (pAuxDa
6730: 74 61 2d 3e 69 41 75 78 4f 70 3d 3d 70 43 74 78 ta->iAuxOp==pCtx
6740: 2d 3e 69 4f 70 20 7c 7c 20 69 41 72 67 3c 30 29 ->iOp || iArg<0)
6750: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
6760: 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78 3b pAuxData->pAux;
6770: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
6780: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn 0;.}../*.**
6790: 53 65 74 20 74 68 65 20 61 75 78 69 6c 69 61 72 Set the auxiliar
67a0: 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72 20 61 y data pointer a
67b0: 6e 64 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 nd delete functi
67c0: 6f 6e 2c 20 66 6f 72 20 74 68 65 20 69 41 72 67 on, for the iArg
67d0: 27 74 68 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 'th.** argument
67e0: 74 6f 20 74 68 65 20 75 73 65 72 2d 66 75 6e 63 to the user-func
67f0: 74 69 6f 6e 20 64 65 66 69 6e 65 64 20 62 79 20 tion defined by
6800: 70 43 74 78 2e 20 41 6e 79 20 70 72 65 76 69 6f pCtx. Any previo
6810: 75 73 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 64 us value is.** d
6820: 65 6c 65 74 65 64 20 62 79 20 63 61 6c 6c 69 6e eleted by callin
6830: 67 20 74 68 65 20 64 65 6c 65 74 65 20 66 75 6e g the delete fun
6840: 63 74 69 6f 6e 20 73 70 65 63 69 66 69 65 64 20 ction specified
6850: 77 68 65 6e 20 69 74 20 77 61 73 20 73 65 74 2e when it was set.
6860: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d .**.** The left-
6870: 6d 6f 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 most argument is
6880: 20 30 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64 6f 63 75 0..**.** Undocu
6890: 6d 65 6e 74 65 64 20 62 65 68 61 76 69 6f 72 3a mented behavior:
68a0: 20 20 49 66 20 69 41 72 67 20 69 73 20 6e 65 67 If iArg is neg
68b0: 61 74 69 76 65 20 74 68 65 6e 20 6d 61 6b 65 20 ative then make
68c0: 74 68 65 20 64 61 74 61 20 61 76 61 69 6c 61 62 the data availab
68d0: 6c 65 0a 2a 2a 20 74 6f 20 61 6c 6c 20 66 75 6e le.** to all fun
68e0: 63 74 69 6f 6e 73 20 77 69 74 68 69 6e 20 74 68 ctions within th
68f0: 65 20 63 75 72 72 65 6e 74 20 70 72 65 70 61 72 e current prepar
6900: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 75 73 69 ed statement usi
6910: 6e 67 20 69 41 72 67 20 61 73 20 61 6e 0a 2a 2a ng iArg as an.**
6920: 20 61 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a 2f access code..*/
6930: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 65 .void sqlite3_se
6940: 74 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71 6c t_auxdata(. sql
6950: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 ite3_context *pC
6960: 74 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67 2c tx, . int iArg,
6970: 20 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20 . void *pAux,
6980: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 74 . void (*xDelet
6990: 65 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 41 e)(void*).){. A
69a0: 75 78 44 61 74 61 20 2a 70 41 75 78 44 61 74 61 uxData *pAuxData
69b0: 3b 0a 20 20 56 64 62 65 20 2a 70 56 64 62 65 20 ;. Vdbe *pVdbe
69c0: 3d 20 70 43 74 78 2d 3e 70 56 64 62 65 3b 0a 0a = pCtx->pVdbe;..
69d0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
69e0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 3_mutex_held(pCt
69f0: 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 x->pOut->db->mut
6a00: 65 78 29 20 29 3b 0a 23 69 66 64 65 66 20 53 51 ex) );.#ifdef SQ
6a10: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
6a20: 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 66 28 3_OR_STAT4. if(
6a30: 20 70 56 64 62 65 3d 3d 30 20 29 20 67 6f 74 6f pVdbe==0 ) goto
6a40: 20 66 61 69 6c 65 64 3b 0a 23 65 6c 73 65 0a 20 failed;.#else.
6a50: 20 61 73 73 65 72 74 28 20 70 56 64 62 65 21 3d assert( pVdbe!=
6a60: 30 20 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 66 0 );.#endif.. f
6a70: 6f 72 28 70 41 75 78 44 61 74 61 3d 70 56 64 62 or(pAuxData=pVdb
6a80: 65 2d 3e 70 41 75 78 44 61 74 61 3b 20 70 41 75 e->pAuxData; pAu
6a90: 78 44 61 74 61 3b 20 70 41 75 78 44 61 74 61 3d xData; pAuxData=
6aa0: 70 41 75 78 44 61 74 61 2d 3e 70 4e 65 78 74 41 pAuxData->pNextA
6ab0: 75 78 29 7b 0a 20 20 20 20 69 66 28 20 70 41 75 ux){. if( pAu
6ac0: 78 44 61 74 61 2d 3e 69 41 75 78 41 72 67 3d 3d xData->iAuxArg==
6ad0: 69 41 72 67 20 26 26 20 28 70 41 75 78 44 61 74 iArg && (pAuxDat
6ae0: 61 2d 3e 69 41 75 78 4f 70 3d 3d 70 43 74 78 2d a->iAuxOp==pCtx-
6af0: 3e 69 4f 70 20 7c 7c 20 69 41 72 67 3c 30 29 20 >iOp || iArg<0)
6b00: 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a ){. break;.
6b10: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
6b20: 70 41 75 78 44 61 74 61 3d 3d 30 20 29 7b 0a 20 pAuxData==0 ){.
6b30: 20 20 20 70 41 75 78 44 61 74 61 20 3d 20 73 71 pAuxData = sq
6b40: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 lite3DbMallocZer
6b50: 6f 28 70 56 64 62 65 2d 3e 64 62 2c 20 73 69 7a o(pVdbe->db, siz
6b60: 65 6f 66 28 41 75 78 44 61 74 61 29 29 3b 0a 20 eof(AuxData));.
6b70: 20 20 20 69 66 28 20 21 70 41 75 78 44 61 74 61 if( !pAuxData
6b80: 20 29 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a ) goto failed;.
6b90: 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e 69 41 pAuxData->iA
6ba0: 75 78 4f 70 20 3d 20 70 43 74 78 2d 3e 69 4f 70 uxOp = pCtx->iOp
6bb0: 3b 0a 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e ;. pAuxData->
6bc0: 69 41 75 78 41 72 67 20 3d 20 69 41 72 67 3b 0a iAuxArg = iArg;.
6bd0: 20 20 20 20 70 41 75 78 44 61 74 61 2d 3e 70 4e pAuxData->pN
6be0: 65 78 74 41 75 78 20 3d 20 70 56 64 62 65 2d 3e extAux = pVdbe->
6bf0: 70 41 75 78 44 61 74 61 3b 0a 20 20 20 20 70 56 pAuxData;. pV
6c00: 64 62 65 2d 3e 70 41 75 78 44 61 74 61 20 3d 20 dbe->pAuxData =
6c10: 70 41 75 78 44 61 74 61 3b 0a 20 20 20 20 69 66 pAuxData;. if
6c20: 28 20 70 43 74 78 2d 3e 66 45 72 72 6f 72 4f 72 ( pCtx->fErrorOr
6c30: 41 75 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 Aux==0 ){.
6c40: 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 pCtx->isError =
6c50: 30 3b 0a 20 20 20 20 20 20 70 43 74 78 2d 3e 66 0;. pCtx->f
6c60: 45 72 72 6f 72 4f 72 41 75 78 20 3d 20 31 3b 0a ErrorOrAux = 1;.
6c70: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 }. }else if
6c80: 28 20 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c ( pAuxData->xDel
6c90: 65 74 65 41 75 78 20 29 7b 0a 20 20 20 20 70 41 eteAux ){. pA
6ca0: 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 41 uxData->xDeleteA
6cb0: 75 78 28 70 41 75 78 44 61 74 61 2d 3e 70 41 75 ux(pAuxData->pAu
6cc0: 78 29 3b 0a 20 20 7d 0a 0a 20 20 70 41 75 78 44 x);. }.. pAuxD
6cd0: 61 74 61 2d 3e 70 41 75 78 20 3d 20 70 41 75 78 ata->pAux = pAux
6ce0: 3b 0a 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44 ;. pAuxData->xD
6cf0: 65 6c 65 74 65 41 75 78 20 3d 20 78 44 65 6c 65 eleteAux = xDele
6d00: 74 65 3b 0a 20 20 72 65 74 75 72 6e 3b 0a 0a 66 te;. return;..f
6d10: 61 69 6c 65 64 3a 0a 20 20 69 66 28 20 78 44 65 ailed:. if( xDe
6d20: 6c 65 74 65 20 29 7b 0a 20 20 20 20 78 44 65 6c lete ){. xDel
6d30: 65 74 65 28 70 41 75 78 29 3b 0a 20 20 7d 0a 7d ete(pAux);. }.}
6d40: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
6d50: 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 _OMIT_DEPRECATED
6d60: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
6d70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 e number of time
6d80: 73 20 74 68 65 20 53 74 65 70 20 66 75 6e 63 74 s the Step funct
6d90: 69 6f 6e 20 6f 66 20 61 6e 20 61 67 67 72 65 67 ion of an aggreg
6da0: 61 74 65 20 68 61 73 20 62 65 65 6e 20 0a 2a 2a ate has been .**
6db0: 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 called..**.** T
6dc0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
6dd0: 64 65 70 72 65 63 61 74 65 64 2e 20 20 44 6f 20 deprecated. Do
6de0: 6e 6f 74 20 75 73 65 20 69 74 20 66 6f 72 20 6e not use it for n
6df0: 65 77 20 63 6f 64 65 2e 20 20 49 74 20 69 73 0a ew code. It is.
6e00: 2a 2a 20 70 72 6f 76 69 64 65 20 6f 6e 6c 79 20 ** provide only
6e10: 74 6f 20 61 76 6f 69 64 20 62 72 65 61 6b 69 6e to avoid breakin
6e20: 67 20 6c 65 67 61 63 79 20 63 6f 64 65 2e 20 20 g legacy code.
6e30: 4e 65 77 20 61 67 67 72 65 67 61 74 65 20 66 75 New aggregate fu
6e40: 6e 63 74 69 6f 6e 0a 2a 2a 20 69 6d 70 6c 65 6d nction.** implem
6e50: 65 6e 74 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 entations should
6e60: 20 6b 65 65 70 20 74 68 65 69 72 20 6f 77 6e 20 keep their own
6e70: 63 6f 75 6e 74 73 20 77 69 74 68 69 6e 20 74 68 counts within th
6e80: 65 69 72 20 61 67 67 72 65 67 61 74 65 0a 2a 2a eir aggregate.**
6e90: 20 63 6f 6e 74 65 78 74 2e 0a 2a 2f 0a 69 6e 74 context..*/.int
6ea0: 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 sqlite3_aggrega
6eb0: 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 te_count(sqlite3
6ec0: 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 _context *p){.
6ed0: 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e assert( p && p->
6ee0: 70 4d 65 6d 20 26 26 20 70 2d 3e 70 46 75 6e 63 pMem && p->pFunc
6ef0: 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 46 && p->pFunc->xF
6f00: 69 6e 61 6c 69 7a 65 20 29 3b 0a 20 20 72 65 74 inalize );. ret
6f10: 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d 3e 6e 3b 0a urn p->pMem->n;.
6f20: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
6f30: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
6f40: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 r of columns in
6f50: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 66 the result set f
6f60: 6f 72 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 or the statement
6f70: 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 pStmt..*/.int s
6f80: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f qlite3_column_co
6f90: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 unt(sqlite3_stmt
6fa0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 *pStmt){. Vdbe
6fb0: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 *pVm = (Vdbe *)
6fc0: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 pStmt;. return
6fd0: 70 56 6d 20 3f 20 70 56 6d 2d 3e 6e 52 65 73 43 pVm ? pVm->nResC
6fe0: 6f 6c 75 6d 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a olumn : 0;.}../*
6ff0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
7000: 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20 umber of values
7010: 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 available from t
7020: 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77 20 6f he current row o
7030: 66 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 f the.** current
7040: 6c 79 20 65 78 65 63 75 74 69 6e 67 20 73 74 61 ly executing sta
7050: 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f tement pStmt..*/
7060: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 61 74 .int sqlite3_dat
7070: 61 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f a_count(sqlite3_
7080: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 stmt *pStmt){.
7090: 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56 64 62 Vdbe *pVm = (Vdb
70a0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 e *)pStmt;. if(
70b0: 20 70 56 6d 3d 3d 30 20 7c 7c 20 70 56 6d 2d 3e pVm==0 || pVm->
70c0: 70 52 65 73 75 6c 74 53 65 74 3d 3d 30 20 29 20 pResultSet==0 )
70d0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75 return 0;. retu
70e0: 72 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 rn pVm->nResColu
70f0: 6d 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 mn;.}../*.** Ret
7100: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f urn a pointer to
7110: 20 73 74 61 74 69 63 20 6d 65 6d 6f 72 79 20 63 static memory c
7120: 6f 6e 74 61 69 6e 69 6e 67 20 61 6e 20 53 51 4c ontaining an SQL
7130: 20 4e 55 4c 4c 20 76 61 6c 75 65 2e 0a 2a 2f 0a NULL value..*/.
7140: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 4d 65 6d static const Mem
7150: 20 2a 63 6f 6c 75 6d 6e 4e 75 6c 6c 56 61 6c 75 *columnNullValu
7160: 65 28 76 6f 69 64 29 7b 0a 20 20 2f 2a 20 45 76 e(void){. /* Ev
7170: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 20 4d 65 en though the Me
7180: 6d 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 m structure cont
7190: 61 69 6e 73 20 61 6e 20 65 6c 65 6d 65 6e 74 0a ains an element.
71a0: 20 20 2a 2a 20 6f 66 20 74 79 70 65 20 69 36 34 ** of type i64
71b0: 2c 20 6f 6e 20 63 65 72 74 61 69 6e 20 61 72 63 , on certain arc
71c0: 68 69 74 65 63 74 75 72 65 73 20 28 78 38 36 29 hitectures (x86)
71d0: 20 77 69 74 68 20 63 65 72 74 61 69 6e 20 63 6f with certain co
71e0: 6d 70 69 6c 65 72 0a 20 20 2a 2a 20 73 77 69 74 mpiler. ** swit
71f0: 63 68 65 73 20 28 2d 4f 73 29 2c 20 67 63 63 20 ches (-Os), gcc
7200: 6d 61 79 20 61 6c 69 67 6e 20 74 68 69 73 20 4d may align this M
7210: 65 6d 20 6f 62 6a 65 63 74 20 6f 6e 20 61 20 34 em object on a 4
7220: 2d 62 79 74 65 20 62 6f 75 6e 64 61 72 79 0a 20 -byte boundary.
7230: 20 2a 2a 20 69 6e 73 74 65 61 64 20 6f 66 20 61 ** instead of a
7240: 6e 20 38 2d 62 79 74 65 20 6f 6e 65 2e 20 54 68 n 8-byte one. Th
7250: 69 73 20 61 6c 6c 20 77 6f 72 6b 73 20 66 69 6e is all works fin
7260: 65 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 77 e, except that w
7270: 68 65 6e 0a 20 20 2a 2a 20 72 75 6e 6e 69 6e 67 hen. ** running
7280: 20 77 69 74 68 20 53 51 4c 49 54 45 5f 44 45 42 with SQLITE_DEB
7290: 55 47 20 64 65 66 69 6e 65 64 20 74 68 65 20 53 UG defined the S
72a0: 51 4c 69 74 65 20 63 6f 64 65 20 73 6f 6d 65 74 QLite code somet
72b0: 69 6d 65 73 20 61 73 73 65 72 74 28 29 73 0a 20 imes assert()s.
72c0: 20 2a 2a 20 74 68 61 74 20 61 20 4d 65 6d 20 73 ** that a Mem s
72d0: 74 72 75 63 74 75 72 65 20 69 73 20 6c 6f 63 61 tructure is loca
72e0: 74 65 64 20 6f 6e 20 61 6e 20 38 2d 62 79 74 65 ted on an 8-byte
72f0: 20 62 6f 75 6e 64 61 72 79 2e 20 54 6f 20 70 72 boundary. To pr
7300: 65 76 65 6e 74 0a 20 20 2a 2a 20 74 68 65 73 65 event. ** these
7310: 20 61 73 73 65 72 74 28 29 73 20 66 72 6f 6d 20 assert()s from
7320: 66 61 69 6c 69 6e 67 2c 20 77 68 65 6e 20 62 75 failing, when bu
7330: 69 6c 64 69 6e 67 20 77 69 74 68 20 53 51 4c 49 ilding with SQLI
7340: 54 45 5f 44 45 42 55 47 20 64 65 66 69 6e 65 64 TE_DEBUG defined
7350: 0a 20 20 2a 2a 20 75 73 69 6e 67 20 67 63 63 2c . ** using gcc,
7360: 20 77 65 20 66 6f 72 63 65 20 6e 75 6c 6c 4d 65 we force nullMe
7370: 6d 20 74 6f 20 62 65 20 38 2d 62 79 74 65 20 61 m to be 8-byte a
7380: 6c 69 67 6e 65 64 20 75 73 69 6e 67 20 74 68 65 ligned using the
7390: 20 6d 61 67 69 63 61 6c 0a 20 20 2a 2a 20 5f 5f magical. ** __
73a0: 61 74 74 72 69 62 75 74 65 5f 5f 28 28 61 6c 69 attribute__((ali
73b0: 67 6e 65 64 28 38 29 29 29 20 6d 61 63 72 6f 2e gned(8))) macro.
73c0: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 6f */. static co
73d0: 6e 73 74 20 4d 65 6d 20 6e 75 6c 6c 4d 65 6d 20 nst Mem nullMem
73e0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
73f0: 49 54 45 5f 44 45 42 55 47 29 20 26 26 20 64 65 ITE_DEBUG) && de
7400: 66 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 0a fined(__GNUC__).
7410: 20 20 20 20 5f 5f 61 74 74 72 69 62 75 74 65 5f __attribute_
7420: 5f 28 28 61 6c 69 67 6e 65 64 28 38 29 29 29 20 _((aligned(8)))
7430: 0a 23 65 6e 64 69 66 0a 20 20 20 20 3d 20 7b 0a .#endif. = {.
7440: 20 20 20 20 20 20 20 20 2f 2a 20 2e 75 20 20 20 /* .u
7450: 20 20 20 20 20 20 20 3d 20 2a 2f 20 7b 30 7d 2c = */ {0},
7460: 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 66 6c 61 . /* .fla
7470: 67 73 20 20 20 20 20 20 3d 20 2a 2f 20 28 75 31 gs = */ (u1
7480: 36 29 4d 45 4d 5f 4e 75 6c 6c 2c 0a 20 20 20 20 6)MEM_Null,.
7490: 20 20 20 20 2f 2a 20 2e 65 6e 63 20 20 20 20 20 /* .enc
74a0: 20 20 20 3d 20 2a 2f 20 28 75 38 29 30 2c 0a 20 = */ (u8)0,.
74b0: 20 20 20 20 20 20 20 2f 2a 20 2e 65 53 75 62 74 /* .eSubt
74c0: 79 70 65 20 20 20 3d 20 2a 2f 20 28 75 38 29 30 ype = */ (u8)0
74d0: 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 6e 20 ,. /* .n
74e0: 20 20 20 20 20 20 20 20 20 3d 20 2a 2f 20 28 69 = */ (i
74f0: 6e 74 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a nt)0,. /*
7500: 20 2e 7a 20 20 20 20 20 20 20 20 20 20 3d 20 2a .z = *
7510: 2f 20 28 63 68 61 72 2a 29 30 2c 0a 20 20 20 20 / (char*)0,.
7520: 20 20 20 20 2f 2a 20 2e 7a 4d 61 6c 6c 6f 63 20 /* .zMalloc
7530: 20 20 20 3d 20 2a 2f 20 28 63 68 61 72 2a 29 30 = */ (char*)0
7540: 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 73 7a ,. /* .sz
7550: 4d 61 6c 6c 6f 63 20 20 20 3d 20 2a 2f 20 28 69 Malloc = */ (i
7560: 6e 74 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a nt)0,. /*
7570: 20 2e 75 54 65 6d 70 20 20 20 20 20 20 3d 20 2a .uTemp = *
7580: 2f 20 28 75 33 32 29 30 2c 0a 20 20 20 20 20 20 / (u32)0,.
7590: 20 20 2f 2a 20 2e 64 62 20 20 20 20 20 20 20 20 /* .db
75a0: 20 3d 20 2a 2f 20 28 73 71 6c 69 74 65 33 2a 29 = */ (sqlite3*)
75b0: 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 78 0,. /* .x
75c0: 44 65 6c 20 20 20 20 20 20 20 3d 20 2a 2f 20 28 Del = */ (
75d0: 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 30 void(*)(void*))0
75e0: 2c 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ,.#ifdef SQLITE_
75f0: 44 45 42 55 47 0a 20 20 20 20 20 20 20 20 2f 2a DEBUG. /*
7600: 20 2e 70 53 63 6f 70 79 46 72 6f 6d 20 3d 20 2a .pScopyFrom = *
7610: 2f 20 28 4d 65 6d 2a 29 30 2c 0a 20 20 20 20 20 / (Mem*)0,.
7620: 20 20 20 2f 2a 20 2e 70 46 69 6c 6c 65 72 20 20 /* .pFiller
7630: 20 20 3d 20 2a 2f 20 28 76 6f 69 64 2a 29 30 2c = */ (void*)0,
7640: 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 7d 3b .#endif. };
7650: 0a 20 20 72 65 74 75 72 6e 20 26 6e 75 6c 6c 4d . return &nullM
7660: 65 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 em;.}../*.** Che
7670: 63 6b 20 74 6f 20 73 65 65 20 69 66 20 63 6f 6c ck to see if col
7680: 75 6d 6e 20 69 43 6f 6c 20 6f 66 20 74 68 65 20 umn iCol of the
7690: 67 69 76 65 6e 20 73 74 61 74 65 6d 65 6e 74 20 given statement
76a0: 69 73 20 76 61 6c 69 64 2e 20 20 49 66 0a 2a 2a is valid. If.**
76b0: 20 69 74 20 69 73 2c 20 72 65 74 75 72 6e 20 61 it is, return a
76c0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
76d0: 4d 65 6d 20 66 6f 72 20 74 68 65 20 76 61 6c 75 Mem for the valu
76e0: 65 20 6f 66 20 74 68 61 74 20 63 6f 6c 75 6d 6e e of that column
76f0: 2e 0a 2a 2a 20 49 66 20 69 43 6f 6c 20 69 73 20 ..** If iCol is
7700: 6e 6f 74 20 76 61 6c 69 64 2c 20 72 65 74 75 72 not valid, retur
7710: 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 n a pointer to a
7720: 20 4d 65 6d 20 77 68 69 63 68 20 68 61 73 20 61 Mem which has a
7730: 20 76 61 6c 75 65 0a 2a 2a 20 6f 66 20 4e 55 4c value.** of NUL
7740: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d L..*/.static Mem
7750: 20 2a 63 6f 6c 75 6d 6e 4d 65 6d 28 73 71 6c 69 *columnMem(sqli
7760: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
7770: 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20 int i){. Vdbe
7780: 2a 70 56 6d 3b 0a 20 20 4d 65 6d 20 2a 70 4f 75 *pVm;. Mem *pOu
7790: 74 3b 0a 0a 20 20 70 56 6d 20 3d 20 28 56 64 62 t;.. pVm = (Vdb
77a0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28 e *)pStmt;. if(
77b0: 20 70 56 6d 3d 3d 30 20 29 20 72 65 74 75 72 6e pVm==0 ) return
77c0: 20 28 4d 65 6d 2a 29 63 6f 6c 75 6d 6e 4e 75 6c (Mem*)columnNul
77d0: 6c 56 61 6c 75 65 28 29 3b 0a 20 20 61 73 73 65 lValue();. asse
77e0: 72 74 28 20 70 56 6d 2d 3e 64 62 20 29 3b 0a 20 rt( pVm->db );.
77f0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
7800: 6e 74 65 72 28 70 56 6d 2d 3e 64 62 2d 3e 6d 75 nter(pVm->db->mu
7810: 74 65 78 29 3b 0a 20 20 69 66 28 20 70 56 6d 2d tex);. if( pVm-
7820: 3e 70 52 65 73 75 6c 74 53 65 74 21 3d 30 20 26 >pResultSet!=0 &
7830: 26 20 69 3c 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c & i<pVm->nResCol
7840: 75 6d 6e 20 26 26 20 69 3e 3d 30 20 29 7b 0a 20 umn && i>=0 ){.
7850: 20 20 20 70 4f 75 74 20 3d 20 26 70 56 6d 2d 3e pOut = &pVm->
7860: 70 52 65 73 75 6c 74 53 65 74 5b 69 5d 3b 0a 20 pResultSet[i];.
7870: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
7880: 74 65 33 45 72 72 6f 72 28 70 56 6d 2d 3e 64 62 te3Error(pVm->db
7890: 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 29 3b , SQLITE_RANGE);
78a0: 0a 20 20 20 20 70 4f 75 74 20 3d 20 28 4d 65 6d . pOut = (Mem
78b0: 2a 29 63 6f 6c 75 6d 6e 4e 75 6c 6c 56 61 6c 75 *)columnNullValu
78c0: 65 28 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 e();. }. retur
78d0: 6e 20 70 4f 75 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n pOut;.}../*.**
78e0: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
78f0: 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 20 69 s called after i
7900: 6e 76 6f 6b 69 6e 67 20 61 6e 20 73 71 6c 69 74 nvoking an sqlit
7910: 65 33 5f 76 61 6c 75 65 5f 58 58 58 20 66 75 6e e3_value_XXX fun
7920: 63 74 69 6f 6e 20 6f 6e 20 61 20 0a 2a 2a 20 63 ction on a .** c
7930: 6f 6c 75 6d 6e 20 76 61 6c 75 65 20 28 69 2e 65 olumn value (i.e
7940: 2e 20 61 20 76 61 6c 75 65 20 72 65 74 75 72 6e . a value return
7950: 65 64 20 62 79 20 65 76 61 6c 75 61 74 69 6e 67 ed by evaluating
7960: 20 61 6e 20 53 51 4c 20 65 78 70 72 65 73 73 69 an SQL expressi
7970: 6f 6e 20 69 6e 20 74 68 65 0a 2a 2a 20 73 65 6c on in the.** sel
7980: 65 63 74 20 6c 69 73 74 20 6f 66 20 61 20 53 45 ect list of a SE
7990: 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 29 20 LECT statement)
79a0: 74 68 61 74 20 6d 61 79 20 63 61 75 73 65 20 61 that may cause a
79b0: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 malloc() failur
79c0: 65 2e 20 49 66 20 0a 2a 2a 20 6d 61 6c 6c 6f 63 e. If .** malloc
79d0: 28 29 20 68 61 73 20 66 61 69 6c 65 64 2c 20 74 () has failed, t
79e0: 68 65 20 74 68 72 65 61 64 73 20 6d 61 6c 6c 6f he threads mallo
79f0: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 69 73 20 cFailed flag is
7a00: 63 6c 65 61 72 65 64 20 61 6e 64 20 74 68 65 20 cleared and the
7a10: 72 65 73 75 6c 74 0a 2a 2a 20 63 6f 64 65 20 6f result.** code o
7a20: 66 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d f statement pStm
7a30: 74 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f t set to SQLITE_
7a40: 4e 4f 4d 45 4d 2e 0a 2a 2a 0a 2a 2a 20 53 70 65 NOMEM..**.** Spe
7a50: 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 20 cifically, this
7a60: 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77 is called from w
7a70: 69 74 68 69 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 ithin:.**.**
7a80: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
7a90: 69 6e 74 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c int().** sql
7aa0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 ite3_column_int6
7ab0: 34 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 4().** sqlit
7ac0: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 29 e3_column_text()
7ad0: 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f .** sqlite3_
7ae0: 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 0a column_text16().
7af0: 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 ** sqlite3_c
7b00: 6f 6c 75 6d 6e 5f 72 65 61 6c 28 29 0a 2a 2a 20 olumn_real().**
7b10: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 sqlite3_colu
7b20: 6d 6e 5f 62 79 74 65 73 28 29 0a 2a 2a 20 20 20 mn_bytes().**
7b30: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e sqlite3_column
7b40: 5f 62 79 74 65 73 31 36 28 29 0a 2a 2a 20 20 20 _bytes16().**
7b50: 20 20 73 71 69 69 74 65 33 5f 63 6f 6c 75 6d 6e sqiite3_column
7b60: 5f 62 6c 6f 62 28 29 0a 2a 2f 0a 73 74 61 74 69 _blob().*/.stati
7b70: 63 20 76 6f 69 64 20 63 6f 6c 75 6d 6e 4d 61 6c c void columnMal
7b80: 6c 6f 63 46 61 69 6c 75 72 65 28 73 71 6c 69 74 locFailure(sqlit
7b90: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 0a e3_stmt *pStmt).
7ba0: 7b 0a 20 20 2f 2a 20 49 66 20 6d 61 6c 6c 6f 63 {. /* If malloc
7bb0: 28 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 () failed during
7bc0: 20 61 6e 20 65 6e 63 6f 64 69 6e 67 20 63 6f 6e an encoding con
7bd0: 76 65 72 73 69 6f 6e 20 77 69 74 68 69 6e 20 61 version within a
7be0: 6e 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 n. ** sqlite3_c
7bf0: 6f 6c 75 6d 6e 5f 58 58 58 20 41 50 49 2c 20 74 olumn_XXX API, t
7c00: 68 65 6e 20 73 65 74 20 74 68 65 20 72 65 74 75 hen set the retu
7c10: 72 6e 20 63 6f 64 65 20 6f 66 20 74 68 65 20 73 rn code of the s
7c20: 74 61 74 65 6d 65 6e 74 20 74 6f 0a 20 20 2a 2a tatement to. **
7c30: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 20 54 SQLITE_NOMEM. T
7c40: 68 65 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f 20 he next call to
7c50: 5f 73 74 65 70 28 29 20 28 69 66 20 61 6e 79 29 _step() (if any)
7c60: 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c will return SQL
7c70: 49 54 45 5f 45 52 52 4f 52 0a 20 20 2a 2a 20 61 ITE_ERROR. ** a
7c80: 6e 64 20 5f 66 69 6e 61 6c 69 7a 65 28 29 20 77 nd _finalize() w
7c90: 69 6c 6c 20 72 65 74 75 72 6e 20 4e 4f 4d 45 4d ill return NOMEM
7ca0: 2e 0a 20 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 .. */. Vdbe *p
7cb0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 = (Vdbe *)pStmt
7cc0: 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 ;. if( p ){.
7cd0: 20 61 73 73 65 72 74 28 20 70 2d 3e 64 62 21 3d assert( p->db!=
7ce0: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
7cf0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
7d00: 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
7d10: 29 20 29 3b 0a 20 20 20 20 70 2d 3e 72 63 20 3d ) );. p->rc =
7d20: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
7d30: 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 29 3b 0a 20 p->db, p->rc);.
7d40: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
7d50: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 _leave(p->db->mu
7d60: 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a tex);. }.}../**
7d70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7d80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 ********** sqlit
7d90: 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a e3_column_ ****
7da0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7db0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 ***********.** T
7dc0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 he following rou
7dd0: 74 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 tines are used t
7de0: 6f 20 61 63 63 65 73 73 20 65 6c 65 6d 65 6e 74 o access element
7df0: 73 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 s of the current
7e00: 20 72 6f 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72 row.** in the r
7e10: 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f esult set..*/.co
7e20: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 nst void *sqlite
7e30: 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71 3_column_blob(sq
7e40: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
7e50: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e t, int i){. con
7e60: 73 74 20 76 6f 69 64 20 2a 76 61 6c 3b 0a 20 20 st void *val;.
7e70: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 val = sqlite3_va
7e80: 6c 75 65 5f 62 6c 6f 62 28 20 63 6f 6c 75 6d 6e lue_blob( column
7e90: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a Mem(pStmt,i) );.
7ea0: 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67 68 /* Even though
7eb0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 65 6e 63 there is no enc
7ec0: 6f 64 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e oding conversion
7ed0: 2c 20 76 61 6c 75 65 5f 62 6c 6f 62 28 29 20 6d , value_blob() m
7ee0: 69 67 68 74 0a 20 20 2a 2a 20 6e 65 65 64 20 74 ight. ** need t
7ef0: 6f 20 63 61 6c 6c 20 6d 61 6c 6c 6f 63 28 29 20 o call malloc()
7f00: 74 6f 20 65 78 70 61 6e 64 20 74 68 65 20 72 65 to expand the re
7f10: 73 75 6c 74 20 6f 66 20 61 20 7a 65 72 6f 62 6c sult of a zerobl
7f20: 6f 62 28 29 20 0a 20 20 2a 2a 20 65 78 70 72 65 ob() . ** expre
7f30: 73 73 69 6f 6e 2e 20 0a 20 20 2a 2f 0a 20 20 63 ssion. . */. c
7f40: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 olumnMallocFailu
7f50: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 re(pStmt);. ret
7f60: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73 urn val;.}.int s
7f70: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 qlite3_column_by
7f80: 74 65 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 tes(sqlite3_stmt
7f90: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b *pStmt, int i){
7fa0: 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c . int val = sql
7fb0: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 ite3_value_bytes
7fc0: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d ( columnMem(pStm
7fd0: 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e t,i) );. column
7fe0: 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 MallocFailure(pS
7ff0: 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 tmt);. return v
8000: 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 al;.}.int sqlite
8010: 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36 3_column_bytes16
8020: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
8030: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 Stmt, int i){.
8040: 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 int val = sqlite
8050: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 3_value_bytes16(
8060: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 columnMem(pStmt
8070: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d ,i) );. columnM
8080: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 allocFailure(pSt
8090: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 mt);. return va
80a0: 6c 3b 0a 7d 0a 64 6f 75 62 6c 65 20 73 71 6c 69 l;.}.double sqli
80b0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c te3_column_doubl
80c0: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a e(sqlite3_stmt *
80d0: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 pStmt, int i){.
80e0: 20 64 6f 75 62 6c 65 20 76 61 6c 20 3d 20 73 71 double val = sq
80f0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 lite3_value_doub
8100: 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 le( columnMem(pS
8110: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 tmt,i) );. colu
8120: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 mnMallocFailure(
8130: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e pStmt);. return
8140: 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 val;.}.int sqli
8150: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 73 te3_column_int(s
8160: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
8170: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e mt, int i){. in
8180: 74 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f t val = sqlite3_
8190: 76 61 6c 75 65 5f 69 6e 74 28 20 63 6f 6c 75 6d value_int( colum
81a0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b nMem(pStmt,i) );
81b0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 . columnMallocF
81c0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 ailure(pStmt);.
81d0: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 73 return val;.}.s
81e0: 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 qlite_int64 sqli
81f0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 te3_column_int64
8200: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
8210: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 Stmt, int i){.
8220: 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 76 61 6c sqlite_int64 val
8230: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 = sqlite3_value
8240: 5f 69 6e 74 36 34 28 20 63 6f 6c 75 6d 6e 4d 65 _int64( columnMe
8250: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 m(pStmt,i) );.
8260: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c columnMallocFail
8270: 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 ure(pStmt);. re
8280: 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 63 6f 6e 73 turn val;.}.cons
8290: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
82a0: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f *sqlite3_column_
82b0: 74 65 78 74 28 73 71 6c 69 74 65 33 5f 73 74 6d text(sqlite3_stm
82c0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 t *pStmt, int i)
82d0: 7b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e {. const unsign
82e0: 65 64 20 63 68 61 72 20 2a 76 61 6c 20 3d 20 73 ed char *val = s
82f0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
8300: 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 t( columnMem(pSt
8310: 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d mt,i) );. colum
8320: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 nMallocFailure(p
8330: 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 Stmt);. return
8340: 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65 33 5f 76 val;.}.sqlite3_v
8350: 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f 63 6f alue *sqlite3_co
8360: 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71 6c 69 74 lumn_value(sqlit
8370: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
8380: 69 6e 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70 int i){. Mem *p
8390: 4f 75 74 20 3d 20 63 6f 6c 75 6d 6e 4d 65 6d 28 Out = columnMem(
83a0: 70 53 74 6d 74 2c 20 69 29 3b 0a 20 20 69 66 28 pStmt, i);. if(
83b0: 20 70 4f 75 74 2d 3e 66 6c 61 67 73 26 4d 45 4d pOut->flags&MEM
83c0: 5f 53 74 61 74 69 63 20 29 7b 0a 20 20 20 20 70 _Static ){. p
83d0: 4f 75 74 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 4d Out->flags &= ~M
83e0: 45 4d 5f 53 74 61 74 69 63 3b 0a 20 20 20 20 70 EM_Static;. p
83f0: 4f 75 74 2d 3e 66 6c 61 67 73 20 7c 3d 20 4d 45 Out->flags |= ME
8400: 4d 5f 45 70 68 65 6d 3b 0a 20 20 7d 0a 20 20 63 M_Ephem;. }. c
8410: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 olumnMallocFailu
8420: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 re(pStmt);. ret
8430: 75 72 6e 20 28 73 71 6c 69 74 65 33 5f 76 61 6c urn (sqlite3_val
8440: 75 65 20 2a 29 70 4f 75 74 3b 0a 7d 0a 23 69 66 ue *)pOut;.}.#if
8450: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
8460: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 _UTF16.const voi
8470: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d d *sqlite3_colum
8480: 6e 5f 74 65 78 74 31 36 28 73 71 6c 69 74 65 33 n_text16(sqlite3
8490: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e _stmt *pStmt, in
84a0: 74 20 69 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f t i){. const vo
84b0: 69 64 20 2a 76 61 6c 20 3d 20 73 71 6c 69 74 65 id *val = sqlite
84c0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 20 3_value_text16(
84d0: 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c columnMem(pStmt,
84e0: 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 i) );. columnMa
84f0: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d llocFailure(pStm
8500: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c t);. return val
8510: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
8520: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 LITE_OMIT_UTF16
8530: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
8540: 6f 6c 75 6d 6e 5f 74 79 70 65 28 73 71 6c 69 74 olumn_type(sqlit
8550: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
8560: 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 69 54 int i){. int iT
8570: 79 70 65 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 ype = sqlite3_va
8580: 6c 75 65 5f 74 79 70 65 28 20 63 6f 6c 75 6d 6e lue_type( column
8590: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a Mem(pStmt,i) );.
85a0: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 columnMallocFa
85b0: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 ilure(pStmt);.
85c0: 72 65 74 75 72 6e 20 69 54 79 70 65 3b 0a 7d 0a return iType;.}.
85d0: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 74 ./*.** Convert t
85e0: 68 65 20 4e 2d 74 68 20 65 6c 65 6d 65 6e 74 20 he N-th element
85f0: 6f 66 20 70 53 74 6d 74 2d 3e 70 43 6f 6c 4e 61 of pStmt->pColNa
8600: 6d 65 5b 5d 20 69 6e 74 6f 20 61 20 73 74 72 69 me[] into a stri
8610: 6e 67 20 75 73 69 6e 67 0a 2a 2a 20 78 46 75 6e ng using.** xFun
8620: 63 28 29 20 74 68 65 6e 20 72 65 74 75 72 6e 20 c() then return
8630: 74 68 61 74 20 73 74 72 69 6e 67 2e 20 20 49 66 that string. If
8640: 20 4e 20 69 73 20 6f 75 74 20 6f 66 20 72 61 6e N is out of ran
8650: 67 65 2c 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2a ge, return 0..**
8660: 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20 75 70 .** There are up
8670: 20 74 6f 20 35 20 6e 61 6d 65 73 20 66 6f 72 20 to 5 names for
8680: 65 61 63 68 20 63 6f 6c 75 6d 6e 2e 20 20 75 73 each column. us
8690: 65 54 79 70 65 20 64 65 74 65 72 6d 69 6e 65 73 eType determines
86a0: 20 77 68 69 63 68 0a 2a 2a 20 6e 61 6d 65 20 69 which.** name i
86b0: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 48 65 72 s returned. Her
86c0: 65 20 61 72 65 20 74 68 65 20 6e 61 6d 65 73 3a e are the names:
86d0: 0a 2a 2a 0a 2a 2a 20 20 20 20 30 20 20 20 20 20 .**.** 0
86e0: 20 54 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 The column name
86f0: 20 61 73 20 69 74 20 73 68 6f 75 6c 64 20 62 65 as it should be
8700: 20 64 69 73 70 6c 61 79 65 64 20 66 6f 72 20 6f displayed for o
8710: 75 74 70 75 74 0a 2a 2a 20 20 20 20 31 20 20 20 utput.** 1
8720: 20 20 20 54 68 65 20 64 61 74 61 74 79 70 65 20 The datatype
8730: 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 63 6f 6c name for the col
8740: 75 6d 6e 0a 2a 2a 20 20 20 20 32 20 20 20 20 20 umn.** 2
8750: 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 The name of the
8760: 20 64 61 74 61 62 61 73 65 20 74 68 61 74 20 74 database that t
8770: 68 65 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 he column derive
8780: 73 20 66 72 6f 6d 0a 2a 2a 20 20 20 20 33 20 20 s from.** 3
8790: 20 20 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 The name of
87a0: 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 74 the table that t
87b0: 68 65 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 he column derive
87c0: 73 20 66 72 6f 6d 0a 2a 2a 20 20 20 20 34 20 20 s from.** 4
87d0: 20 20 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 The name of
87e0: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e the table column
87f0: 20 74 68 61 74 20 74 68 65 20 72 65 73 75 6c 74 that the result
8800: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 20 column derives
8810: 66 72 6f 6d 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 from.**.** If th
8820: 65 20 72 65 73 75 6c 74 20 69 73 20 6e 6f 74 20 e result is not
8830: 61 20 73 69 6d 70 6c 65 20 63 6f 6c 75 6d 6e 20 a simple column
8840: 72 65 66 65 72 65 6e 63 65 20 28 69 66 20 69 74 reference (if it
8850: 20 69 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f is an expressio
8860: 6e 0a 2a 2a 20 6f 72 20 61 20 63 6f 6e 73 74 61 n.** or a consta
8870: 6e 74 29 20 74 68 65 6e 20 75 73 65 54 79 70 65 nt) then useType
8880: 73 20 32 2c 20 33 2c 20 61 6e 64 20 34 20 72 65 s 2, 3, and 4 re
8890: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 turn NULL..*/.st
88a0: 61 74 69 63 20 63 6f 6e 73 74 20 76 6f 69 64 20 atic const void
88b0: 2a 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 73 *columnName(. s
88c0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
88d0: 6d 74 2c 0a 20 20 69 6e 74 20 4e 2c 0a 20 20 63 mt,. int N,. c
88e0: 6f 6e 73 74 20 76 6f 69 64 20 2a 28 2a 78 46 75 onst void *(*xFu
88f0: 6e 63 29 28 4d 65 6d 2a 29 2c 0a 20 20 69 6e 74 nc)(Mem*),. int
8900: 20 75 73 65 54 79 70 65 0a 29 7b 0a 20 20 63 6f useType.){. co
8910: 6e 73 74 20 76 6f 69 64 20 2a 72 65 74 3b 0a 20 nst void *ret;.
8920: 20 56 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20 Vdbe *p;. int
8930: 6e 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 n;. sqlite3 *db
8940: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
8950: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
8960: 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 . if( pStmt==0
8970: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
8980: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
8990: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
89a0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 20 }.#endif. ret
89b0: 3d 20 30 3b 0a 20 20 70 20 3d 20 28 56 64 62 65 = 0;. p = (Vdbe
89c0: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 64 62 20 3d *)pStmt;. db =
89d0: 20 70 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 p->db;. assert
89e0: 28 20 64 62 21 3d 30 20 29 3b 0a 20 20 6e 20 3d ( db!=0 );. n =
89f0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
8a00: 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b 0a 20 20 count(pStmt);.
8a10: 69 66 28 20 4e 3c 6e 20 26 26 20 4e 3e 3d 30 20 if( N<n && N>=0
8a20: 29 7b 0a 20 20 20 20 4e 20 2b 3d 20 75 73 65 54 ){. N += useT
8a30: 79 70 65 2a 6e 3b 0a 20 20 20 20 73 71 6c 69 74 ype*n;. sqlit
8a40: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
8a50: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 61 b->mutex);. a
8a60: 73 73 65 72 74 28 20 64 62 2d 3e 6d 61 6c 6c 6f ssert( db->mallo
8a70: 63 46 61 69 6c 65 64 3d 3d 30 20 29 3b 0a 20 20 cFailed==0 );.
8a80: 20 20 72 65 74 20 3d 20 78 46 75 6e 63 28 26 70 ret = xFunc(&p
8a90: 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a ->aColName[N]);.
8aa0: 20 20 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 /* A malloc
8ab0: 20 6d 61 79 20 68 61 76 65 20 66 61 69 6c 65 64 may have failed
8ac0: 20 69 6e 73 69 64 65 20 6f 66 20 74 68 65 20 78 inside of the x
8ad0: 46 75 6e 63 28 29 20 63 61 6c 6c 2e 20 49 66 20 Func() call. If
8ae0: 74 68 69 73 0a 20 20 20 20 2a 2a 20 69 73 20 74 this. ** is t
8af0: 68 65 20 63 61 73 65 2c 20 63 6c 65 61 72 20 74 he case, clear t
8b00: 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 he mallocFailed
8b10: 66 6c 61 67 20 61 6e 64 20 72 65 74 75 72 6e 20 flag and return
8b20: 4e 55 4c 4c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 NULL.. */.
8b30: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
8b40: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 73 ailed ){. s
8b50: 71 6c 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 64 qlite3OomClear(d
8b60: 62 29 3b 0a 20 20 20 20 20 20 72 65 74 20 3d 20 b);. ret =
8b70: 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 0;. }. sql
8b80: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
8b90: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d (db->mutex);. }
8ba0: 0a 20 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d . return ret;.}
8bb0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
8bc0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e he name of the N
8bd0: 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 th column of the
8be0: 20 72 65 73 75 6c 74 20 73 65 74 20 72 65 74 75 result set retu
8bf0: 72 6e 65 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 rned by SQL.** s
8c00: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a tatement pStmt..
8c10: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
8c20: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 qlite3_column_na
8c30: 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 me(sqlite3_stmt
8c40: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a *pStmt, int N){.
8c50: 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e return columnN
8c60: 61 6d 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 ame(. pStmt
8c70: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 , N, (const void
8c80: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 *(*)(Mem*))sqlit
8c90: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 e3_value_text, C
8ca0: 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a OLNAME_NAME);.}.
8cb0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
8cc0: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 MIT_UTF16.const
8cd0: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f void *sqlite3_co
8ce0: 6c 75 6d 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 lumn_name16(sqli
8cf0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
8d00: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 int N){. retur
8d10: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 n columnName(.
8d20: 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 pStmt, N, (c
8d30: 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 onst void*(*)(Me
8d40: 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 m*))sqlite3_valu
8d50: 65 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d e_text16, COLNAM
8d60: 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 65 6e 64 69 E_NAME);.}.#endi
8d70: 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 72 61 f../*.** Constra
8d80: 69 6e 74 3a 20 20 49 66 20 79 6f 75 20 68 61 76 int: If you hav
8d90: 65 20 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f e ENABLE_COLUMN_
8da0: 4d 45 54 41 44 41 54 41 20 74 68 65 6e 20 79 6f METADATA then yo
8db0: 75 20 6d 75 73 74 0a 2a 2a 20 6e 6f 74 20 64 65 u must.** not de
8dc0: 66 69 6e 65 20 4f 4d 49 54 5f 44 45 43 4c 54 59 fine OMIT_DECLTY
8dd0: 50 45 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e PE..*/.#if defin
8de0: 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ed(SQLITE_OMIT_D
8df0: 45 43 4c 54 59 50 45 29 20 26 26 20 64 65 66 69 ECLTYPE) && defi
8e00: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
8e10: 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 E_COLUMN_METADAT
8e20: 41 29 0a 23 20 65 72 72 6f 72 20 22 4d 75 73 74 A).# error "Must
8e30: 20 6e 6f 74 20 64 65 66 69 6e 65 20 62 6f 74 68 not define both
8e40: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 SQLITE_OMIT_DEC
8e50: 4c 54 59 50 45 20 5c 0a 20 20 20 20 20 20 20 20 LTYPE \.
8e60: 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 4e 41 42 and SQLITE_ENAB
8e70: 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 LE_COLUMN_METADA
8e80: 54 41 22 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e TA".#endif..#ifn
8e90: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
8ea0: 44 45 43 4c 54 59 50 45 0a 2f 2a 0a 2a 2a 20 52 DECLTYPE./*.** R
8eb0: 65 74 75 72 6e 20 74 68 65 20 63 6f 6c 75 6d 6e eturn the column
8ec0: 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 74 79 70 declaration typ
8ed0: 65 20 28 69 66 20 61 70 70 6c 69 63 61 62 6c 65 e (if applicable
8ee0: 29 20 6f 66 20 74 68 65 20 27 69 27 74 68 20 63 ) of the 'i'th c
8ef0: 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 olumn.** of the
8f00: 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20 53 51 result set of SQ
8f10: 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d L statement pStm
8f20: 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 t..*/.const char
8f30: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e *sqlite3_column
8f40: 5f 64 65 63 6c 74 79 70 65 28 73 71 6c 69 74 65 _decltype(sqlite
8f50: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
8f60: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 nt N){. return
8f70: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 columnName(.
8f80: 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e pStmt, N, (con
8f90: 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a st void*(*)(Mem*
8fa0: 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f ))sqlite3_value_
8fb0: 74 65 78 74 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 text, COLNAME_DE
8fc0: 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 69 66 6e 64 CLTYPE);.}.#ifnd
8fd0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
8fe0: 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 TF16.const void
8ff0: 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f *sqlite3_column_
9000: 64 65 63 6c 74 79 70 65 31 36 28 73 71 6c 69 74 decltype16(sqlit
9010: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
9020: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e int N){. return
9030: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 columnName(.
9040: 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f pStmt, N, (co
9050: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d nst void*(*)(Mem
9060: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 *))sqlite3_value
9070: 5f 74 65 78 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 _text16, COLNAME
9080: 5f 44 45 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 65 _DECLTYPE);.}.#e
9090: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
90a0: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e MIT_UTF16 */.#en
90b0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
90c0: 49 54 5f 44 45 43 4c 54 59 50 45 20 2a 2f 0a 0a IT_DECLTYPE */..
90d0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
90e0: 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 ABLE_COLUMN_META
90f0: 44 41 54 41 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 DATA./*.** Retur
9100: 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 n the name of th
9110: 65 20 64 61 74 61 62 61 73 65 20 66 72 6f 6d 20 e database from
9120: 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 which a result c
9130: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a olumn derives..*
9140: 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e * NULL is return
9150: 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 ed if the result
9160: 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 column is an ex
9170: 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 pression or cons
9180: 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 tant or.** anyth
9190: 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 ing else which i
91a0: 73 20 6e 6f 74 20 61 6e 20 75 6e 61 6d 62 69 67 s not an unambig
91b0: 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 uous reference t
91c0: 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c o a database col
91d0: 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 umn..*/.const ch
91e0: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 ar *sqlite3_colu
91f0: 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 mn_database_name
9200: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
9210: 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 Stmt, int N){.
9220: 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d return columnNam
9230: 65 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 e(. pStmt,
9240: 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 N, (const void*(
9250: 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 *)(Mem*))sqlite3
9260: 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c _value_text, COL
9270: 4e 41 4d 45 5f 44 41 54 41 42 41 53 45 29 3b 0a NAME_DATABASE);.
9280: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 }.#ifndef SQLITE
9290: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 _OMIT_UTF16.cons
92a0: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f t void *sqlite3_
92b0: 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f column_database_
92c0: 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73 name16(sqlite3_s
92d0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
92e0: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c N){. return col
92f0: 75 6d 6e 4e 61 6d 65 28 0a 20 20 20 20 20 20 70 umnName(. p
9300: 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 Stmt, N, (const
9310: 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 void*(*)(Mem*))s
9320: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
9330: 74 31 36 2c 20 43 4f 4c 4e 41 4d 45 5f 44 41 54 t16, COLNAME_DAT
9340: 41 42 41 53 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 ABASE);.}.#endif
9350: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
9360: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 UTF16 */../*.**
9370: 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 Return the name
9380: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f of the table fro
9390: 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 m which a result
93a0: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e column derives.
93b0: 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 .** NULL is retu
93c0: 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75 rned if the resu
93d0: 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 lt column is an
93e0: 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f expression or co
93f0: 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 nstant or.** any
9400: 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 thing else which
9410: 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 6d 62 is not an unamb
9420: 69 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 iguous reference
9430: 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 to a database c
9440: 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 olumn..*/.const
9450: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f char *sqlite3_co
9460: 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28 lumn_table_name(
9470: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
9480: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 tmt, int N){. r
9490: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 eturn columnName
94a0: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e (. pStmt, N
94b0: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a , (const void*(*
94c0: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f )(Mem*))sqlite3_
94d0: 76 61 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e value_text, COLN
94e0: 41 4d 45 5f 54 41 42 4c 45 29 3b 0a 7d 0a 23 69 AME_TABLE);.}.#i
94f0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
9500: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f T_UTF16.const vo
9510: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 id *sqlite3_colu
9520: 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28 mn_table_name16(
9530: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
9540: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 tmt, int N){. r
9550: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 eturn columnName
9560: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e (. pStmt, N
9570: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a , (const void*(*
9580: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f )(Mem*))sqlite3_
9590: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 43 4f value_text16, CO
95a0: 4c 4e 41 4d 45 5f 54 41 42 4c 45 29 3b 0a 7d 0a LNAME_TABLE);.}.
95b0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
95c0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a _OMIT_UTF16 */..
95d0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
95e0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
95f0: 6c 65 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 77 le column from w
9600: 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f hich a result co
9610: 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a lumn derives..**
9620: 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 NULL is returne
9630: 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 d if the result
9640: 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 column is an exp
9650: 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 ression or const
9660: 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 ant or.** anythi
9670: 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 ng else which is
9680: 20 6e 6f 74 20 61 6e 20 75 6e 61 6d 62 69 67 75 not an unambigu
9690: 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f ous reference to
96a0: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 a database colu
96b0: 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 mn..*/.const cha
96c0: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d r *sqlite3_colum
96d0: 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 28 73 71 n_origin_name(sq
96e0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
96f0: 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 t, int N){. ret
9700: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 0a urn columnName(.
9710: 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e 2c 20 pStmt, N,
9720: 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 (const void*(*)(
9730: 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 Mem*))sqlite3_va
9740: 6c 75 65 5f 74 65 78 74 2c 20 43 4f 4c 4e 41 4d lue_text, COLNAM
9750: 45 5f 43 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23 69 66 E_COLUMN);.}.#if
9760: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
9770: 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 _UTF16.const voi
9780: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d d *sqlite3_colum
9790: 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 36 28 n_origin_name16(
97a0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
97b0: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 tmt, int N){. r
97c0: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 eturn columnName
97d0: 28 0a 20 20 20 20 20 20 70 53 74 6d 74 2c 20 4e (. pStmt, N
97e0: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a , (const void*(*
97f0: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f )(Mem*))sqlite3_
9800: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 43 4f value_text16, CO
9810: 4c 4e 41 4d 45 5f 43 4f 4c 55 4d 4e 29 3b 0a 7d LNAME_COLUMN);.}
9820: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
9830: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a E_OMIT_UTF16 */.
9840: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
9850: 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d _ENABLE_COLUMN_M
9860: 45 54 41 44 41 54 41 20 2a 2f 0a 0a 0a 2f 2a 2a ETADATA */.../**
9870: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
9880: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 ************* sq
9890: 6c 69 74 65 33 5f 62 69 6e 64 5f 20 20 2a 2a 2a lite3_bind_ ***
98a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
98b0: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20 ********.** .**
98c0: 52 6f 75 74 69 6e 65 73 20 75 73 65 64 20 74 6f Routines used to
98d0: 20 61 74 74 61 63 68 20 76 61 6c 75 65 73 20 74 attach values t
98e0: 6f 20 77 69 6c 64 63 61 72 64 73 20 69 6e 20 61 o wildcards in a
98f0: 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20 73 74 compiled SQL st
9900: 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a atement..*/./*.*
9910: 2a 20 55 6e 62 69 6e 64 20 74 68 65 20 76 61 6c * Unbind the val
9920: 75 65 20 62 6f 75 6e 64 20 74 6f 20 76 61 72 69 ue bound to vari
9930: 61 62 6c 65 20 69 20 69 6e 20 76 69 72 74 75 61 able i in virtua
9940: 6c 20 6d 61 63 68 69 6e 65 20 70 2e 20 54 68 69 l machine p. Thi
9950: 73 20 69 73 20 74 68 65 20 0a 2a 2a 20 74 68 65 s is the .** the
9960: 20 73 61 6d 65 20 61 73 20 62 69 6e 64 69 6e 67 same as binding
9970: 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 20 74 6f a NULL value to
9980: 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 20 49 66 20 the column. If
9990: 74 68 65 20 22 69 22 20 70 61 72 61 6d 65 74 65 the "i" paramete
99a0: 72 20 69 73 0a 2a 2a 20 6f 75 74 20 6f 66 20 72 r is.** out of r
99b0: 61 6e 67 65 2c 20 74 68 65 6e 20 53 51 4c 49 54 ange, then SQLIT
99c0: 45 5f 52 41 4e 47 45 20 69 73 20 72 65 74 75 72 E_RANGE is retur
99d0: 6e 65 64 2e 20 4f 74 68 65 77 69 73 65 20 53 51 ned. Othewise SQ
99e0: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 41 LITE_OK..**.** A
99f0: 20 73 75 63 63 65 73 73 66 75 6c 20 65 76 61 6c successful eval
9a00: 75 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 72 uation of this r
9a10: 6f 75 74 69 6e 65 20 61 63 71 75 69 72 65 73 20 outine acquires
9a20: 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 70 2e 0a the mutex on p..
9a30: 2a 2a 20 74 68 65 20 6d 75 74 65 78 20 69 73 20 ** the mutex is
9a40: 72 65 6c 65 61 73 65 64 20 69 66 20 61 6e 79 20 released if any
9a50: 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 6f 63 kind of error oc
9a60: 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 curs..**.** The
9a70: 65 72 72 6f 72 20 63 6f 64 65 20 73 74 6f 72 65 error code store
9a80: 64 20 69 6e 20 64 61 74 61 62 61 73 65 20 70 2d d in database p-
9a90: 3e 64 62 20 69 73 20 6f 76 65 72 77 72 69 74 74 >db is overwritt
9aa0: 65 6e 20 77 69 74 68 20 74 68 65 20 72 65 74 75 en with the retu
9ab0: 72 6e 0a 2a 2a 20 76 61 6c 75 65 20 69 6e 20 61 rn.** value in a
9ac0: 6e 79 20 63 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 ny case..*/.stat
9ad0: 69 63 20 69 6e 74 20 76 64 62 65 55 6e 62 69 6e ic int vdbeUnbin
9ae0: 64 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 d(Vdbe *p, int i
9af0: 29 7b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a ){. Mem *pVar;.
9b00: 20 20 69 66 28 20 76 64 62 65 53 61 66 65 74 79 if( vdbeSafety
9b10: 4e 6f 74 4e 75 6c 6c 28 70 29 20 29 7b 0a 20 20 NotNull(p) ){.
9b20: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
9b30: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d MISUSE_BKPT;. }
9b40: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
9b50: 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 _enter(p->db->mu
9b60: 74 65 78 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6d tex);. if( p->m
9b70: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 agic!=VDBE_MAGIC
9b80: 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30 _RUN || p->pc>=0
9b90: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 ){. sqlite3E
9ba0: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 rror(p->db, SQLI
9bb0: 54 45 5f 4d 49 53 55 53 45 29 3b 0a 20 20 20 20 TE_MISUSE);.
9bc0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
9bd0: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 ave(p->db->mutex
9be0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c );. sqlite3_l
9bf0: 6f 67 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 og(SQLITE_MISUSE
9c00: 2c 20 0a 20 20 20 20 20 20 20 20 22 62 69 6e 64 , . "bind
9c10: 20 6f 6e 20 61 20 62 75 73 79 20 70 72 65 70 61 on a busy prepa
9c20: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 3a 20 5b red statement: [
9c30: 25 73 5d 22 2c 20 70 2d 3e 7a 53 71 6c 29 3b 0a %s]", p->zSql);.
9c40: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
9c50: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
9c60: 20 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c 7c 20 }. if( i<1 ||
9c70: 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 i>p->nVar ){.
9c80: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d sqlite3Error(p-
9c90: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e 47 >db, SQLITE_RANG
9ca0: 45 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f E);. sqlite3_
9cb0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 mutex_leave(p->d
9cc0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 b->mutex);. r
9cd0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e eturn SQLITE_RAN
9ce0: 47 45 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 GE;. }. i--;.
9cf0: 20 70 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 pVar = &p->aVar
9d00: 5b 69 5d 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 [i];. sqlite3Vd
9d10: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 56 61 beMemRelease(pVa
9d20: 72 29 3b 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 r);. pVar->flag
9d30: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 s = MEM_Null;.
9d40: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e sqlite3Error(p->
9d50: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a db, SQLITE_OK);.
9d60: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 62 69 74 . /* If the bit
9d70: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
9d80: 6f 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 20 o this variable
9d90: 69 6e 20 56 64 62 65 2e 65 78 70 6d 61 73 6b 20 in Vdbe.expmask
9da0: 69 73 20 73 65 74 2c 20 74 68 65 6e 20 0a 20 20 is set, then .
9db0: 2a 2a 20 62 69 6e 64 69 6e 67 20 61 20 6e 65 77 ** binding a new
9dc0: 20 76 61 6c 75 65 20 74 6f 20 74 68 69 73 20 76 value to this v
9dd0: 61 72 69 61 62 6c 65 20 69 6e 76 61 6c 69 64 61 ariable invalida
9de0: 74 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 tes the current
9df0: 71 75 65 72 79 20 70 6c 61 6e 2e 0a 20 20 2a 2a query plan.. **
9e00: 0a 20 20 2a 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 . ** IMPLEMENTA
9e10: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 34 38 34 34 30 TION-OF: R-48440
9e20: 2d 33 37 35 39 35 20 49 66 20 74 68 65 20 73 70 -37595 If the sp
9e30: 65 63 69 66 69 63 20 76 61 6c 75 65 20 62 6f 75 ecific value bou
9e40: 6e 64 20 74 6f 20 68 6f 73 74 0a 20 20 2a 2a 20 nd to host. **
9e50: 70 61 72 61 6d 65 74 65 72 20 69 6e 20 74 68 65 parameter in the
9e60: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 6d 69 WHERE clause mi
9e70: 67 68 74 20 69 6e 66 6c 75 65 6e 63 65 20 74 68 ght influence th
9e80: 65 20 63 68 6f 69 63 65 20 6f 66 20 71 75 65 72 e choice of quer
9e90: 79 20 70 6c 61 6e 0a 20 20 2a 2a 20 66 6f 72 20 y plan. ** for
9ea0: 61 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 a statement, the
9eb0: 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 n the statement
9ec0: 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 will be automati
9ed0: 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 cally recompiled
9ee0: 2c 0a 20 20 2a 2a 20 61 73 20 69 66 20 74 68 65 ,. ** as if the
9ef0: 72 65 20 68 61 64 20 62 65 65 6e 20 61 20 73 63 re had been a sc
9f00: 68 65 6d 61 20 63 68 61 6e 67 65 2c 20 6f 6e 20 hema change, on
9f10: 74 68 65 20 66 69 72 73 74 20 73 71 6c 69 74 65 the first sqlite
9f20: 33 5f 73 74 65 70 28 29 20 63 61 6c 6c 0a 20 20 3_step() call.
9f30: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 79 ** following any
9f40: 20 63 68 61 6e 67 65 20 74 6f 20 74 68 65 20 62 change to the b
9f50: 69 6e 64 69 6e 67 73 20 6f 66 20 74 68 61 74 20 indings of that
9f60: 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 2a 2f 0a parameter.. */.
9f70: 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e 70 72 assert( (p->pr
9f80: 65 70 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 epFlags & SQLITE
9f90: 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c _PREPARE_SAVESQL
9fa0: 29 21 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 6d 61 )!=0 || p->expma
9fb0: 73 6b 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 sk==0 );. if( p
9fc0: 2d 3e 65 78 70 6d 61 73 6b 21 3d 30 20 26 26 20 ->expmask!=0 &&
9fd0: 28 70 2d 3e 65 78 70 6d 61 73 6b 20 26 20 28 69 (p->expmask & (i
9fe0: 3e 3d 33 31 20 3f 20 30 78 38 30 30 30 30 30 30 >=31 ? 0x8000000
9ff0: 30 20 3a 20 28 75 33 32 29 31 3c 3c 69 29 29 21 0 : (u32)1<<i))!
a000: 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 65 78 70 =0 ){. p->exp
a010: 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 ired = 1;. }.
a020: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
a030: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20 ;.}../*.** Bind
a040: 61 20 74 65 78 74 20 6f 72 20 42 4c 4f 42 20 76 a text or BLOB v
a050: 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 alue..*/.static
a060: 69 6e 74 20 62 69 6e 64 54 65 78 74 28 0a 20 20 int bindText(.
a070: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
a080: 74 6d 74 2c 20 20 20 2f 2a 20 54 68 65 20 73 74 tmt, /* The st
a090: 61 74 65 6d 65 6e 74 20 74 6f 20 62 69 6e 64 20 atement to bind
a0a0: 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74 against */. int
a0b0: 20 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 i,
a0c0: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 /* Index of
a0d0: 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 74 6f the parameter to
a0e0: 20 62 69 6e 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 bind */. const
a0f0: 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 20 20 void *zData,
a100: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
a110: 74 68 65 20 64 61 74 61 20 74 6f 20 62 65 20 62 the data to be b
a120: 6f 75 6e 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 44 ound */. int nD
a130: 61 74 61 2c 20 20 20 20 20 20 20 20 20 20 20 20 ata,
a140: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 /* Number of by
a150: 74 65 73 20 6f 66 20 64 61 74 61 20 74 6f 20 62 tes of data to b
a160: 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 76 6f 69 e bound */. voi
a170: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 d (*xDel)(void*)
a180: 2c 20 20 20 2f 2a 20 44 65 73 74 72 75 63 74 6f , /* Destructo
a190: 72 20 66 6f 72 20 74 68 65 20 64 61 74 61 20 2a r for the data *
a1a0: 2f 0a 20 20 75 38 20 65 6e 63 6f 64 69 6e 67 20 /. u8 encoding
a1b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 6e /* En
a1c0: 63 6f 64 69 6e 67 20 66 6f 72 20 74 68 65 20 64 coding for the d
a1d0: 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 ata */.){. Vdbe
a1e0: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 *p = (Vdbe *)pS
a1f0: 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72 tmt;. Mem *pVar
a200: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72 ;. int rc;.. r
a210: 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 c = vdbeUnbind(p
a220: 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d , i);. if( rc==
a230: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
a240: 20 69 66 28 20 7a 44 61 74 61 21 3d 30 20 29 7b if( zData!=0 ){
a250: 0a 20 20 20 20 20 20 70 56 61 72 20 3d 20 26 70 . pVar = &p
a260: 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b 0a 20 20 20 ->aVar[i-1];.
a270: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 rc = sqlite3V
a280: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61 dbeMemSetStr(pVa
a290: 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c r, zData, nData,
a2a0: 20 65 6e 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29 encoding, xDel)
a2b0: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
a2c0: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 6e 63 SQLITE_OK && enc
a2d0: 6f 64 69 6e 67 21 3d 30 20 29 7b 0a 20 20 20 20 oding!=0 ){.
a2e0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
a2f0: 56 64 62 65 43 68 61 6e 67 65 45 6e 63 6f 64 69 VdbeChangeEncodi
a300: 6e 67 28 70 56 61 72 2c 20 45 4e 43 28 70 2d 3e ng(pVar, ENC(p->
a310: 64 62 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 db));. }.
a320: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
a330: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 sqlite3Err
a340: 6f 72 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 or(p->db, rc);.
a350: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
a360: 74 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62 te3ApiExit(p->db
a370: 2c 20 72 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 , rc);. }.
a380: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
a390: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e _mutex_leave(p->
a3a0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 db->mutex);. }e
a3b0: 6c 73 65 20 69 66 28 20 78 44 65 6c 21 3d 53 51 lse if( xDel!=SQ
a3c0: 4c 49 54 45 5f 53 54 41 54 49 43 20 26 26 20 78 LITE_STATIC && x
a3d0: 44 65 6c 21 3d 53 51 4c 49 54 45 5f 54 52 41 4e Del!=SQLITE_TRAN
a3e0: 53 49 45 4e 54 20 29 7b 0a 20 20 20 20 78 44 65 SIENT ){. xDe
a3f0: 6c 28 28 76 6f 69 64 2a 29 7a 44 61 74 61 29 3b l((void*)zData);
a400: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
a410: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 ;.}.../*.** Bind
a420: 20 61 20 62 6c 6f 62 20 76 61 6c 75 65 20 74 6f a blob value to
a430: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e an SQL statemen
a440: 74 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 69 t variable..*/.i
a450: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f nt sqlite3_bind_
a460: 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f blob(. sqlite3_
a470: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 stmt *pStmt, .
a480: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 int i, . const
a490: 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 void *zData, .
a4a0: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f int nData, . vo
a4b0: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a id (*xDel)(void*
a4c0: 29 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 ).){.#ifdef SQLI
a4d0: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
a4e0: 4d 4f 52 0a 20 20 69 66 28 20 6e 44 61 74 61 3c MOR. if( nData<
a4f0: 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 0 ) return SQLIT
a500: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
a510: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 62 endif. return b
a520: 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69 indText(pStmt, i
a530: 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 , zData, nData,
a540: 78 44 65 6c 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20 xDel, 0);.}.int
a550: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f sqlite3_bind_blo
a560: 62 36 34 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 b64(. sqlite3_s
a570: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 tmt *pStmt, . i
a580: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 nt i, . const v
a590: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 73 oid *zData, . s
a5a0: 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6e 44 qlite3_uint64 nD
a5b0: 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 ata, . void (*x
a5c0: 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 Del)(void*).){.
a5d0: 20 61 73 73 65 72 74 28 20 78 44 65 6c 21 3d 53 assert( xDel!=S
a5e0: 51 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b QLITE_DYNAMIC );
a5f0: 0a 20 20 69 66 28 20 6e 44 61 74 61 3e 30 78 37 . if( nData>0x7
a600: 66 66 66 66 66 66 66 20 29 7b 0a 20 20 20 20 72 fffffff ){. r
a610: 65 74 75 72 6e 20 69 6e 76 6f 6b 65 56 61 6c 75 eturn invokeValu
a620: 65 44 65 73 74 72 75 63 74 6f 72 28 7a 44 61 74 eDestructor(zDat
a630: 61 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 20 20 7d a, xDel, 0);. }
a640: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e else{. return
a650: 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c bindText(pStmt,
a660: 20 69 2c 20 7a 44 61 74 61 2c 20 28 69 6e 74 29 i, zData, (int)
a670: 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b nData, xDel, 0);
a680: 0a 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 . }.}.int sqlit
a690: 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73 e3_bind_double(s
a6a0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
a6b0: 6d 74 2c 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c mt, int i, doubl
a6c0: 65 20 72 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 e rValue){. int
a6d0: 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d rc;. Vdbe *p =
a6e0: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a (Vdbe *)pStmt;.
a6f0: 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e rc = vdbeUnbin
a700: 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 d(p, i);. if( r
a710: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
a720: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d sqlite3VdbeM
a730: 65 6d 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e emSetDouble(&p->
a740: 61 56 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75 aVar[i-1], rValu
a750: 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f e);. sqlite3_
a760: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 mutex_leave(p->d
a770: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 b->mutex);. }.
a780: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e return rc;.}.in
a790: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 t sqlite3_bind_i
a7a0: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 nt(sqlite3_stmt
a7b0: 2a 70 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69 *p, int i, int i
a7c0: 56 61 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e Value){. return
a7d0: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e sqlite3_bind_in
a7e0: 74 36 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69 t64(p, i, (i64)i
a7f0: 56 61 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 Value);.}.int sq
a800: 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34 lite3_bind_int64
a810: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
a820: 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c Stmt, int i, sql
a830: 69 74 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65 ite_int64 iValue
a840: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 ){. int rc;. V
a850: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a dbe *p = (Vdbe *
a860: 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 )pStmt;. rc = v
a870: 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b dbeUnbind(p, i);
a880: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
a890: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
a8a0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 te3VdbeMemSetInt
a8b0: 36 34 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 64(&p->aVar[i-1]
a8c0: 2c 20 69 56 61 6c 75 65 29 3b 0a 20 20 20 20 73 , iValue);. s
a8d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
a8e0: 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 ve(p->db->mutex)
a8f0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
a900: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 c;.}.int sqlite3
a910: 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74 _bind_null(sqlit
a920: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
a930: 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 72 63 int i){. int rc
a940: 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 ;. Vdbe *p = (V
a950: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 dbe*)pStmt;. rc
a960: 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c = vdbeUnbind(p,
a970: 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 i);. if( rc==S
a980: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
a990: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
a9a0: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 ave(p->db->mutex
a9b0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
a9c0: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 rc;.}.int sqlite
a9d0: 33 5f 62 69 6e 64 5f 70 6f 69 6e 74 65 72 28 0a 3_bind_pointer(.
a9e0: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
a9f0: 70 53 74 6d 74 2c 0a 20 20 69 6e 74 20 69 2c 0a pStmt,. int i,.
aa00: 20 20 76 6f 69 64 20 2a 70 50 74 72 2c 0a 20 20 void *pPtr,.
aa10: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 54 74 const char *zPTt
aa20: 79 70 65 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 ype,. void (*xD
aa30: 65 73 74 72 75 63 74 6f 72 29 28 76 6f 69 64 2a estructor)(void*
aa40: 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ).){. int rc;.
aa50: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 Vdbe *p = (Vdbe
aa60: 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 *)pStmt;. rc =
aa70: 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 vdbeUnbind(p, i)
aa80: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
aa90: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
aaa0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 50 6f ite3VdbeMemSetPo
aab0: 69 6e 74 65 72 28 26 70 2d 3e 61 56 61 72 5b 69 inter(&p->aVar[i
aac0: 2d 31 5d 2c 20 70 50 74 72 2c 20 7a 50 54 74 79 -1], pPtr, zPTty
aad0: 70 65 2c 20 78 44 65 73 74 72 75 63 74 6f 72 29 pe, xDestructor)
aae0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 ;. sqlite3_mu
aaf0: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d tex_leave(p->db-
ab00: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 >mutex);. }else
ab10: 20 69 66 28 20 78 44 65 73 74 72 75 63 74 6f 72 if( xDestructor
ab20: 20 29 7b 0a 20 20 20 20 78 44 65 73 74 72 75 63 ){. xDestruc
ab30: 74 6f 72 28 70 50 74 72 29 3b 0a 20 20 7d 0a 20 tor(pPtr);. }.
ab40: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e return rc;.}.in
ab50: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 t sqlite3_bind_t
ab60: 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65 33 5f ext( . sqlite3_
ab70: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 stmt *pStmt, .
ab80: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 int i, . const
ab90: 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a 20 20 char *zData, .
aba0: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f int nData, . vo
abb0: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a id (*xDel)(void*
abc0: 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 ).){. return bi
abd0: 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69 2c ndText(pStmt, i,
abe0: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 zData, nData, x
abf0: 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 Del, SQLITE_UTF8
ac00: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 );.}.int sqlite3
ac10: 5f 62 69 6e 64 5f 74 65 78 74 36 34 28 20 0a 20 _bind_text64( .
ac20: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 sqlite3_stmt *p
ac30: 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20 Stmt, . int i,
ac40: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
ac50: 44 61 74 61 2c 20 0a 20 20 73 71 6c 69 74 65 33 Data, . sqlite3
ac60: 5f 75 69 6e 74 36 34 20 6e 44 61 74 61 2c 20 0a _uint64 nData, .
ac70: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 void (*xDel)(v
ac80: 6f 69 64 2a 29 2c 0a 20 20 75 6e 73 69 67 6e 65 oid*),. unsigne
ac90: 64 20 63 68 61 72 20 65 6e 63 0a 29 7b 0a 20 20 d char enc.){.
aca0: 61 73 73 65 72 74 28 20 78 44 65 6c 21 3d 53 51 assert( xDel!=SQ
acb0: 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a LITE_DYNAMIC );.
acc0: 20 20 69 66 28 20 6e 44 61 74 61 3e 30 78 37 66 if( nData>0x7f
acd0: 66 66 66 66 66 66 20 29 7b 0a 20 20 20 20 72 65 ffffff ){. re
ace0: 74 75 72 6e 20 69 6e 76 6f 6b 65 56 61 6c 75 65 turn invokeValue
acf0: 44 65 73 74 72 75 63 74 6f 72 28 7a 44 61 74 61 Destructor(zData
ad00: 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 20 20 7d 65 , xDel, 0);. }e
ad10: 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 65 6e 63 lse{. if( enc
ad20: 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29 ==SQLITE_UTF16 )
ad30: 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 enc = SQLITE_UT
ad40: 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 72 F16NATIVE;. r
ad50: 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70 eturn bindText(p
ad60: 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 Stmt, i, zData,
ad70: 28 69 6e 74 29 6e 44 61 74 61 2c 20 78 44 65 6c (int)nData, xDel
ad80: 2c 20 65 6e 63 29 3b 0a 20 20 7d 0a 7d 0a 23 69 , enc);. }.}.#i
ad90: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
ada0: 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 T_UTF16.int sqli
adb0: 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36 28 te3_bind_text16(
adc0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 . sqlite3_stmt
add0: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 *pStmt, . int i
ade0: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 , . const void
adf0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e *zData, . int n
ae00: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a Data, . void (*
ae10: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a xDel)(void*).){.
ae20: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78 return bindTex
ae30: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 t(pStmt, i, zDat
ae40: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 a, nData, xDel,
ae50: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 SQLITE_UTF16NATI
ae60: 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a VE);.}.#endif /*
ae70: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
ae80: 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 16 */.int sqlite
ae90: 33 5f 62 69 6e 64 5f 76 61 6c 75 65 28 73 71 6c 3_bind_value(sql
aea0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
aeb0: 2c 20 69 6e 74 20 69 2c 20 63 6f 6e 73 74 20 73 , int i, const s
aec0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
aed0: 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b alue){. int rc;
aee0: 0a 20 20 73 77 69 74 63 68 28 20 73 71 6c 69 74 . switch( sqlit
aef0: 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 28 73 e3_value_type((s
af00: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 70 56 qlite3_value*)pV
af10: 61 6c 75 65 29 20 29 7b 0a 20 20 20 20 63 61 73 alue) ){. cas
af20: 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 e SQLITE_INTEGER
af30: 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 : {. rc = s
af40: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 qlite3_bind_int6
af50: 34 28 70 53 74 6d 74 2c 20 69 2c 20 70 56 61 6c 4(pStmt, i, pVal
af60: 75 65 2d 3e 75 2e 69 29 3b 0a 20 20 20 20 20 20 ue->u.i);.
af70: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
af80: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4c 4f case SQLITE_FLO
af90: 41 54 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d AT: {. rc =
afa0: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f sqlite3_bind_do
afb0: 75 62 6c 65 28 70 53 74 6d 74 2c 20 69 2c 20 70 uble(pStmt, i, p
afc0: 56 61 6c 75 65 2d 3e 75 2e 72 29 3b 0a 20 20 20 Value->u.r);.
afd0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
afe0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
aff0: 42 4c 4f 42 3a 20 7b 0a 20 20 20 20 20 20 69 66 BLOB: {. if
b000: 28 20 70 56 61 6c 75 65 2d 3e 66 6c 61 67 73 20 ( pValue->flags
b010: 26 20 4d 45 4d 5f 5a 65 72 6f 20 29 7b 0a 20 20 & MEM_Zero ){.
b020: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
b030: 65 33 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 e3_bind_zeroblob
b040: 28 70 53 74 6d 74 2c 20 69 2c 20 70 56 61 6c 75 (pStmt, i, pValu
b050: 65 2d 3e 75 2e 6e 5a 65 72 6f 29 3b 0a 20 20 20 e->u.nZero);.
b060: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
b070: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 62 rc = sqlite3_b
b080: 69 6e 64 5f 62 6c 6f 62 28 70 53 74 6d 74 2c 20 ind_blob(pStmt,
b090: 69 2c 20 70 56 61 6c 75 65 2d 3e 7a 2c 20 70 56 i, pValue->z, pV
b0a0: 61 6c 75 65 2d 3e 6e 2c 53 51 4c 49 54 45 5f 54 alue->n,SQLITE_T
b0b0: 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 20 20 20 RANSIENT);.
b0c0: 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a }. break;.
b0d0: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 }. case S
b0e0: 51 4c 49 54 45 5f 54 45 58 54 3a 20 7b 0a 20 20 QLITE_TEXT: {.
b0f0: 20 20 20 20 72 63 20 3d 20 62 69 6e 64 54 65 78 rc = bindTex
b100: 74 28 70 53 74 6d 74 2c 69 2c 20 20 70 56 61 6c t(pStmt,i, pVal
b110: 75 65 2d 3e 7a 2c 20 70 56 61 6c 75 65 2d 3e 6e ue->z, pValue->n
b120: 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 , SQLITE_TRANSIE
b130: 4e 54 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 NT,.
b140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b150: 20 20 70 56 61 6c 75 65 2d 3e 65 6e 63 29 3b 0a pValue->enc);.
b160: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b170: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 }. default:
b180: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
b190: 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28 70 ite3_bind_null(p
b1a0: 53 74 6d 74 2c 20 69 29 3b 0a 20 20 20 20 20 20 Stmt, i);.
b1b0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d break;. }. }
b1c0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
b1d0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 int sqlite3_bind
b1e0: 5f 7a 65 72 6f 62 6c 6f 62 28 73 71 6c 69 74 65 _zeroblob(sqlite
b1f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
b200: 6e 74 20 69 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 nt i, int n){.
b210: 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a int rc;. Vdbe *
b220: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d p = (Vdbe *)pStm
b230: 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e t;. rc = vdbeUn
b240: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 bind(p, i);. if
b250: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
b260: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 ){. sqlite3Vd
b270: 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62 beMemSetZeroBlob
b280: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20 (&p->aVar[i-1],
b290: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f n);. sqlite3_
b2a0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 mutex_leave(p->d
b2b0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 b->mutex);. }.
b2c0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e return rc;.}.in
b2d0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 7a t sqlite3_bind_z
b2e0: 65 72 6f 62 6c 6f 62 36 34 28 73 71 6c 69 74 65 eroblob64(sqlite
b2f0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
b300: 6e 74 20 69 2c 20 73 71 6c 69 74 65 33 5f 75 69 nt i, sqlite3_ui
b310: 6e 74 36 34 20 6e 29 7b 0a 20 20 69 6e 74 20 72 nt64 n){. int r
b320: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 c;. Vdbe *p = (
b330: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 Vdbe *)pStmt;.
b340: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
b350: 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 ter(p->db->mutex
b360: 29 3b 0a 20 20 69 66 28 20 6e 3e 28 75 36 34 29 );. if( n>(u64)
b370: 70 2d 3e 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 p->db->aLimit[SQ
b380: 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 LITE_LIMIT_LENGT
b390: 48 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 H] ){. rc = S
b3a0: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20 QLITE_TOOBIG;.
b3b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 }else{. asser
b3c0: 74 28 20 28 6e 20 26 20 30 78 37 46 46 46 46 46 t( (n & 0x7FFFFF
b3d0: 46 46 29 3d 3d 6e 20 29 3b 0a 20 20 20 20 72 63 FF)==n );. rc
b3e0: 20 3d 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f = sqlite3_bind_
b3f0: 7a 65 72 6f 62 6c 6f 62 28 70 53 74 6d 74 2c 20 zeroblob(pStmt,
b400: 69 2c 20 6e 29 3b 0a 20 20 7d 0a 20 20 72 63 20 i, n);. }. rc
b410: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
b420: 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 73 (p->db, rc);. s
b430: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
b440: 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 ve(p->db->mutex)
b450: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
b460: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
b470: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c he number of wil
b480: 64 63 61 72 64 73 20 74 68 61 74 20 63 61 6e 20 dcards that can
b490: 62 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62 be potentially b
b4a0: 6f 75 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73 ound to..** This
b4b0: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 64 64 65 routine is adde
b4c0: 64 20 74 6f 20 73 75 70 70 6f 72 74 20 44 42 44 d to support DBD
b4d0: 3a 3a 53 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69 ::SQLite. .*/.i
b4e0: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f nt sqlite3_bind_
b4f0: 70 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28 parameter_count(
b500: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
b510: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 tmt){. Vdbe *p
b520: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a = (Vdbe*)pStmt;.
b530: 20 20 72 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e return p ? p->
b540: 6e 56 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a nVar : 0;.}../*.
b550: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 ** Return the na
b560: 6d 65 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64 me of a wildcard
b570: 20 70 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74 parameter. Ret
b580: 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 urn NULL if the
b590: 69 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20 index.** is out
b5a0: 6f 66 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74 of range or if t
b5b0: 68 65 20 77 69 6c 64 63 61 72 64 20 69 73 20 75 he wildcard is u
b5c0: 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 nnamed..**.** Th
b5d0: 65 20 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61 e result is alwa
b5e0: 79 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e ys UTF-8..*/.con
b5f0: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
b600: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f _bind_parameter_
b610: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d name(sqlite3_stm
b620: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 t *pStmt, int i)
b630: 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 {. Vdbe *p = (V
b640: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 dbe*)pStmt;. if
b650: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 ( p==0 ) return
b660: 30 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 0;. return sqli
b670: 74 65 33 56 4c 69 73 74 4e 75 6d 54 6f 4e 61 6d te3VListNumToNam
b680: 65 28 70 2d 3e 70 56 4c 69 73 74 2c 20 69 29 3b e(p->pVList, i);
b690: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 .}../*.** Given
b6a0: 61 20 77 69 6c 64 63 61 72 64 20 70 61 72 61 6d a wildcard param
b6b0: 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74 75 72 eter name, retur
b6c0: 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 n the index of t
b6d0: 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 77 he variable.** w
b6e0: 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e 20 20 ith that name.
b6f0: 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 76 If there is no v
b700: 61 72 69 61 62 6c 65 20 77 69 74 68 20 74 68 65 ariable with the
b710: 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a 20 given name,.**
b720: 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74 return 0..*/.int
b730: 20 73 71 6c 69 74 65 33 56 64 62 65 50 61 72 61 sqlite3VdbePara
b740: 6d 65 74 65 72 49 6e 64 65 78 28 56 64 62 65 20 meterIndex(Vdbe
b750: 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a *p, const char *
b760: 7a 4e 61 6d 65 2c 20 69 6e 74 20 6e 4e 61 6d 65 zName, int nName
b770: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c ){. if( p==0 ||
b780: 20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 zName==0 ) retu
b790: 72 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 73 rn 0;. return s
b7a0: 71 6c 69 74 65 33 56 4c 69 73 74 4e 61 6d 65 54 qlite3VListNameT
b7b0: 6f 4e 75 6d 28 70 2d 3e 70 56 4c 69 73 74 2c 20 oNum(p->pVList,
b7c0: 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b 0a 7d zName, nName);.}
b7d0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e .int sqlite3_bin
b7e0: 64 5f 70 61 72 61 6d 65 74 65 72 5f 69 6e 64 65 d_parameter_inde
b7f0: 78 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a x(sqlite3_stmt *
b800: 70 53 74 6d 74 2c 20 63 6f 6e 73 74 20 63 68 61 pStmt, const cha
b810: 72 20 2a 7a 4e 61 6d 65 29 7b 0a 20 20 72 65 74 r *zName){. ret
b820: 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65 50 urn sqlite3VdbeP
b830: 61 72 61 6d 65 74 65 72 49 6e 64 65 78 28 28 56 arameterIndex((V
b840: 64 62 65 2a 29 70 53 74 6d 74 2c 20 7a 4e 61 6d dbe*)pStmt, zNam
b850: 65 2c 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e e, sqlite3Strlen
b860: 33 30 28 7a 4e 61 6d 65 29 29 3b 0a 7d 0a 0a 2f 30(zName));.}../
b870: 2a 0a 2a 2a 20 54 72 61 6e 73 66 65 72 20 61 6c *.** Transfer al
b880: 6c 20 62 69 6e 64 69 6e 67 73 20 66 72 6f 6d 20 l bindings from
b890: 74 68 65 20 66 69 72 73 74 20 73 74 61 74 65 6d the first statem
b8a0: 65 6e 74 20 6f 76 65 72 20 74 6f 20 74 68 65 20 ent over to the
b8b0: 73 65 63 6f 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73 second..*/.int s
b8c0: 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 qlite3TransferBi
b8d0: 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 ndings(sqlite3_s
b8e0: 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d 74 2c 20 tmt *pFromStmt,
b8f0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 54 sqlite3_stmt *pT
b900: 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a oStmt){. Vdbe *
b910: 70 46 72 6f 6d 20 3d 20 28 56 64 62 65 2a 29 70 pFrom = (Vdbe*)p
b920: 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 62 65 FromStmt;. Vdbe
b930: 20 2a 70 54 6f 20 3d 20 28 56 64 62 65 2a 29 70 *pTo = (Vdbe*)p
b940: 54 6f 53 74 6d 74 3b 0a 20 20 69 6e 74 20 69 3b ToStmt;. int i;
b950: 0a 20 20 61 73 73 65 72 74 28 20 70 54 6f 2d 3e . assert( pTo->
b960: 64 62 3d 3d 70 46 72 6f 6d 2d 3e 64 62 20 29 3b db==pFrom->db );
b970: 0a 20 20 61 73 73 65 72 74 28 20 70 54 6f 2d 3e . assert( pTo->
b980: 6e 56 61 72 3d 3d 70 46 72 6f 6d 2d 3e 6e 56 61 nVar==pFrom->nVa
b990: 72 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d r );. sqlite3_m
b9a0: 75 74 65 78 5f 65 6e 74 65 72 28 70 54 6f 2d 3e utex_enter(pTo->
b9b0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 66 6f db->mutex);. fo
b9c0: 72 28 69 3d 30 3b 20 69 3c 70 46 72 6f 6d 2d 3e r(i=0; i<pFrom->
b9d0: 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 nVar; i++){.
b9e0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f sqlite3VdbeMemMo
b9f0: 76 65 28 26 70 54 6f 2d 3e 61 56 61 72 5b 69 5d ve(&pTo->aVar[i]
ba00: 2c 20 26 70 46 72 6f 6d 2d 3e 61 56 61 72 5b 69 , &pFrom->aVar[i
ba10: 5d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 ]);. }. sqlite
ba20: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 54 3_mutex_leave(pT
ba30: 6f 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 o->db->mutex);.
ba40: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
ba50: 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 K;.}..#ifndef SQ
ba60: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
ba70: 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72 65 ATED./*.** Depre
ba80: 63 61 74 65 64 20 65 78 74 65 72 6e 61 6c 20 69 cated external i
ba90: 6e 74 65 72 66 61 63 65 2e 20 20 49 6e 74 65 72 nterface. Inter
baa0: 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65 20 nal/core SQLite
bab0: 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20 63 code.** should c
bac0: 61 6c 6c 20 73 71 6c 69 74 65 33 54 72 61 6e 73 all sqlite3Trans
bad0: 66 65 72 42 69 6e 64 69 6e 67 73 2e 0a 2a 2a 0a ferBindings..**.
bae0: 2a 2a 20 49 74 20 69 73 20 6d 69 73 75 73 65 20 ** It is misuse
baf0: 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 to call this rou
bb00: 74 69 6e 65 20 77 69 74 68 20 73 74 61 74 65 6d tine with statem
bb10: 65 6e 74 73 20 66 72 6f 6d 20 64 69 66 66 65 72 ents from differ
bb20: 65 6e 74 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 ent.** database
bb30: 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 20 42 75 connections. Bu
bb40: 74 20 61 73 20 74 68 69 73 20 69 73 20 61 20 64 t as this is a d
bb50: 65 70 72 65 63 61 74 65 64 20 69 6e 74 65 72 66 eprecated interf
bb60: 61 63 65 2c 20 77 65 0a 2a 2a 20 77 69 6c 6c 20 ace, we.** will
bb70: 6e 6f 74 20 62 6f 74 68 65 72 20 74 6f 20 63 68 not bother to ch
bb80: 65 63 6b 20 66 6f 72 20 74 68 61 74 20 63 6f 6e eck for that con
bb90: 64 69 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 dition..**.** If
bba0: 20 74 68 65 20 74 77 6f 20 73 74 61 74 65 6d 65 the two stateme
bbb0: 6e 74 73 20 63 6f 6e 74 61 69 6e 20 61 20 64 69 nts contain a di
bbc0: 66 66 65 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f fferent number o
bbd0: 66 20 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 6e f bindings, then
bbe0: 0a 2a 2a 20 61 6e 20 53 51 4c 49 54 45 5f 45 52 .** an SQLITE_ER
bbf0: 52 4f 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e ROR is returned.
bc00: 20 20 4e 6f 74 68 69 6e 67 20 65 6c 73 65 20 63 Nothing else c
bc10: 61 6e 20 67 6f 20 77 72 6f 6e 67 2c 20 73 6f 20 an go wrong, so
bc20: 6f 74 68 65 72 77 69 73 65 0a 2a 2a 20 53 51 4c otherwise.** SQL
bc30: 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
bc40: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
bc50: 65 33 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64 e3_transfer_bind
bc60: 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 74 6d ings(sqlite3_stm
bc70: 74 20 2a 70 46 72 6f 6d 53 74 6d 74 2c 20 73 71 t *pFromStmt, sq
bc80: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 54 6f 53 lite3_stmt *pToS
bc90: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 46 tmt){. Vdbe *pF
bca0: 72 6f 6d 20 3d 20 28 56 64 62 65 2a 29 70 46 72 rom = (Vdbe*)pFr
bcb0: 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 62 65 20 2a omStmt;. Vdbe *
bcc0: 70 54 6f 20 3d 20 28 56 64 62 65 2a 29 70 54 6f pTo = (Vdbe*)pTo
bcd0: 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 46 72 6f Stmt;. if( pFro
bce0: 6d 2d 3e 6e 56 61 72 21 3d 70 54 6f 2d 3e 6e 56 m->nVar!=pTo->nV
bcf0: 61 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ar ){. return
bd00: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
bd10: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28 70 54 }. assert( (pT
bd20: 6f 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 20 53 o->prepFlags & S
bd30: 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 QLITE_PREPARE_SA
bd40: 56 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 54 6f VESQL)!=0 || pTo
bd50: 2d 3e 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b 0a ->expmask==0 );.
bd60: 20 20 69 66 28 20 70 54 6f 2d 3e 65 78 70 6d 61 if( pTo->expma
bd70: 73 6b 20 29 7b 0a 20 20 20 20 70 54 6f 2d 3e 65 sk ){. pTo->e
bd80: 78 70 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d 0a xpired = 1;. }.
bd90: 20 20 61 73 73 65 72 74 28 20 28 70 46 72 6f 6d assert( (pFrom
bda0: 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 20 53 51 ->prepFlags & SQ
bdb0: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 LITE_PREPARE_SAV
bdc0: 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 46 72 6f ESQL)!=0 || pFro
bdd0: 6d 2d 3e 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b m->expmask==0 );
bde0: 0a 20 20 69 66 28 20 70 46 72 6f 6d 2d 3e 65 78 . if( pFrom->ex
bdf0: 70 6d 61 73 6b 20 29 7b 0a 20 20 20 20 70 46 72 pmask ){. pFr
be00: 6f 6d 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b om->expired = 1;
be10: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71 . }. return sq
be20: 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e lite3TransferBin
be30: 64 69 6e 67 73 28 70 46 72 6f 6d 53 74 6d 74 2c dings(pFromStmt,
be40: 20 70 54 6f 53 74 6d 74 29 3b 0a 7d 0a 23 65 6e pToStmt);.}.#en
be50: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 dif../*.** Retur
be60: 6e 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 64 n the sqlite3* d
be70: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 atabase handle t
be80: 6f 20 77 68 69 63 68 20 74 68 65 20 70 72 65 70 o which the prep
be90: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 67 ared statement g
bea0: 69 76 65 6e 0a 2a 2a 20 69 6e 20 74 68 65 20 61 iven.** in the a
beb0: 72 67 75 6d 65 6e 74 20 62 65 6c 6f 6e 67 73 2e rgument belongs.
bec0: 20 20 54 68 69 73 20 69 73 20 74 68 65 20 73 61 This is the sa
bed0: 6d 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 me database hand
bee0: 6c 65 20 74 68 61 74 20 77 61 73 0a 2a 2a 20 74 le that was.** t
bef0: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
bf00: 74 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 t to the sqlite3
bf10: 5f 70 72 65 70 61 72 65 28 29 20 74 68 61 74 20 _prepare() that
bf20: 77 61 73 20 75 73 65 64 20 74 6f 20 63 72 65 61 was used to crea
bf30: 74 65 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 6d te.** the statem
bf40: 65 6e 74 20 69 6e 20 74 68 65 20 66 69 72 73 74 ent in the first
bf50: 20 70 6c 61 63 65 2e 0a 2a 2f 0a 73 71 6c 69 74 place..*/.sqlit
bf60: 65 33 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 68 e3 *sqlite3_db_h
bf70: 61 6e 64 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 andle(sqlite3_st
bf80: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65 mt *pStmt){. re
bf90: 74 75 72 6e 20 70 53 74 6d 74 20 3f 20 28 28 56 turn pStmt ? ((V
bfa0: 64 62 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 20 dbe*)pStmt)->db
bfb0: 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 : 0;.}../*.** Re
bfc0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 turn true if the
bfd0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d prepared statem
bfe0: 65 6e 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 ent is guarantee
bff0: 64 20 74 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 20 d to not modify
c000: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e the.** database.
c010: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
c020: 73 74 6d 74 5f 72 65 61 64 6f 6e 6c 79 28 73 71 stmt_readonly(sq
c030: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d lite3_stmt *pStm
c040: 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 t){. return pSt
c050: 6d 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 mt ? ((Vdbe*)pSt
c060: 6d 74 29 2d 3e 72 65 61 64 4f 6e 6c 79 20 3a 20 mt)->readOnly :
c070: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 1;.}../*.** Retu
c080: 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 70 rn true if the p
c090: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e repared statemen
c0a0: 74 20 69 73 20 69 6e 20 6e 65 65 64 20 6f 66 20 t is in need of
c0b0: 62 65 69 6e 67 20 72 65 73 65 74 2e 0a 2a 2f 0a being reset..*/.
c0c0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 int sqlite3_stmt
c0d0: 5f 62 75 73 79 28 73 71 6c 69 74 65 33 5f 73 74 _busy(sqlite3_st
c0e0: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 mt *pStmt){. Vd
c0f0: 62 65 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 be *v = (Vdbe*)p
c100: 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 76 Stmt;. return v
c110: 21 3d 30 20 26 26 20 76 2d 3e 6d 61 67 69 63 3d !=0 && v->magic=
c120: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 =VDBE_MAGIC_RUN
c130: 26 26 20 76 2d 3e 70 63 3e 3d 30 3b 0a 7d 0a 0a && v->pc>=0;.}..
c140: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 /*.** Return a p
c150: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e 65 ointer to the ne
c160: 78 74 20 70 72 65 70 61 72 65 64 20 73 74 61 74 xt prepared stat
c170: 65 6d 65 6e 74 20 61 66 74 65 72 20 70 53 74 6d ement after pStm
c180: 74 20 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 t associated.**
c190: 77 69 74 68 20 64 61 74 61 62 61 73 65 20 63 6f with database co
c1a0: 6e 6e 65 63 74 69 6f 6e 20 70 44 62 2e 20 20 49 nnection pDb. I
c1b0: 66 20 70 53 74 6d 74 20 69 73 20 4e 55 4c 4c 2c f pStmt is NULL,
c1c0: 20 72 65 74 75 72 6e 20 74 68 65 20 66 69 72 73 return the firs
c1d0: 74 0a 2a 2a 20 70 72 65 70 61 72 65 64 20 73 74 t.** prepared st
c1e0: 61 74 65 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 atement for the
c1f0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
c200: 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c ion. Return NUL
c210: 4c 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 L if there.** ar
c220: 65 20 6e 6f 20 6d 6f 72 65 2e 0a 2a 2f 0a 73 71 e no more..*/.sq
c230: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 73 71 6c 69 lite3_stmt *sqli
c240: 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74 28 73 71 te3_next_stmt(sq
c250: 6c 69 74 65 33 20 2a 70 44 62 2c 20 73 71 6c 69 lite3 *pDb, sqli
c260: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 te3_stmt *pStmt)
c270: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 {. sqlite3_stmt
c280: 20 2a 70 4e 65 78 74 3b 0a 23 69 66 64 65 66 20 *pNext;.#ifdef
c290: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
c2a0: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
c2b0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
c2c0: 6b 4f 6b 28 70 44 62 29 20 29 7b 0a 20 20 20 20 kOk(pDb) ){.
c2d0: 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 (void)SQLITE_MIS
c2e0: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 USE_BKPT;. re
c2f0: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 turn 0;. }.#end
c300: 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
c310: 65 78 5f 65 6e 74 65 72 28 70 44 62 2d 3e 6d 75 ex_enter(pDb->mu
c320: 74 65 78 29 3b 0a 20 20 69 66 28 20 70 53 74 6d tex);. if( pStm
c330: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4e 65 78 t==0 ){. pNex
c340: 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73 74 6d t = (sqlite3_stm
c350: 74 2a 29 70 44 62 2d 3e 70 56 64 62 65 3b 0a 20 t*)pDb->pVdbe;.
c360: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e 65 78 }else{. pNex
c370: 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73 74 6d t = (sqlite3_stm
c380: 74 2a 29 28 28 56 64 62 65 2a 29 70 53 74 6d 74 t*)((Vdbe*)pStmt
c390: 29 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 )->pNext;. }.
c3a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
c3b0: 61 76 65 28 70 44 62 2d 3e 6d 75 74 65 78 29 3b ave(pDb->mutex);
c3c0: 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 78 74 3b . return pNext;
c3d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
c3e0: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 the value of a
c3f0: 73 74 61 74 75 73 20 63 6f 75 6e 74 65 72 20 66 status counter f
c400: 6f 72 20 61 20 70 72 65 70 61 72 65 64 20 73 74 or a prepared st
c410: 61 74 65 6d 65 6e 74 0a 2a 2f 0a 69 6e 74 20 73 atement.*/.int s
c420: 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73 74 61 74 qlite3_stmt_stat
c430: 75 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 us(sqlite3_stmt
c440: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 6f 70 2c 20 *pStmt, int op,
c450: 69 6e 74 20 72 65 73 65 74 46 6c 61 67 29 7b 0a int resetFlag){.
c460: 20 20 56 64 62 65 20 2a 70 56 64 62 65 20 3d 20 Vdbe *pVdbe =
c470: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 (Vdbe*)pStmt;.
c480: 75 33 32 20 76 3b 0a 23 69 66 64 65 66 20 53 51 u32 v;.#ifdef SQ
c490: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
c4a0: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 70 53 74 ARMOR. if( !pSt
c4b0: 6d 74 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 mt ){. (void)
c4c0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
c4d0: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 PT;. return 0
c4e0: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 ;. }.#endif. i
c4f0: 66 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 53 54 f( op==SQLITE_ST
c500: 4d 54 53 54 41 54 55 53 5f 4d 45 4d 55 53 45 44 MTSTATUS_MEMUSED
c510: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 ){. sqlite3
c520: 2a 64 62 20 3d 20 70 56 64 62 65 2d 3e 64 62 3b *db = pVdbe->db;
c530: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 . sqlite3_mut
c540: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
c550: 65 78 29 3b 0a 20 20 20 20 76 20 3d 20 30 3b 0a ex);. v = 0;.
c560: 20 20 20 20 64 62 2d 3e 70 6e 42 79 74 65 73 46 db->pnBytesF
c570: 72 65 65 64 20 3d 20 28 69 6e 74 2a 29 26 76 3b reed = (int*)&v;
c580: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 . sqlite3Vdbe
c590: 43 6c 65 61 72 4f 62 6a 65 63 74 28 64 62 2c 20 ClearObject(db,
c5a0: 70 56 64 62 65 29 3b 0a 20 20 20 20 73 71 6c 69 pVdbe);. sqli
c5b0: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 56 te3DbFree(db, pV
c5c0: 64 62 65 29 3b 0a 20 20 20 20 64 62 2d 3e 70 6e dbe);. db->pn
c5d0: 42 79 74 65 73 46 72 65 65 64 20 3d 20 30 3b 0a BytesFreed = 0;.
c5e0: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
c5f0: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
c600: 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 x);. }else{.
c610: 20 76 20 3d 20 70 56 64 62 65 2d 3e 61 43 6f 75 v = pVdbe->aCou
c620: 6e 74 65 72 5b 6f 70 5d 3b 0a 20 20 20 20 69 66 nter[op];. if
c630: 28 20 72 65 73 65 74 46 6c 61 67 20 29 20 70 56 ( resetFlag ) pV
c640: 64 62 65 2d 3e 61 43 6f 75 6e 74 65 72 5b 6f 70 dbe->aCounter[op
c650: 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 ] = 0;. }. ret
c660: 75 72 6e 20 28 69 6e 74 29 76 3b 0a 7d 0a 0a 2f urn (int)v;.}../
c670: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
c680: 53 51 4c 20 61 73 73 6f 63 69 61 74 65 64 20 77 SQL associated w
c690: 69 74 68 20 61 20 70 72 65 70 61 72 65 64 20 73 ith a prepared s
c6a0: 74 61 74 65 6d 65 6e 74 0a 2a 2f 0a 63 6f 6e 73 tatement.*/.cons
c6b0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f t char *sqlite3_
c6c0: 73 71 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 sql(sqlite3_stmt
c6d0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 *pStmt){. Vdbe
c6e0: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 *p = (Vdbe *)pS
c6f0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 20 tmt;. return p
c700: 3f 20 70 2d 3e 7a 53 71 6c 20 3a 20 30 3b 0a 7d ? p->zSql : 0;.}
c710: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
c720: 68 65 20 53 51 4c 20 61 73 73 6f 63 69 61 74 65 he SQL associate
c730: 64 20 77 69 74 68 20 61 20 70 72 65 70 61 72 65 d with a prepare
c740: 64 20 73 74 61 74 65 6d 65 6e 74 20 77 69 74 68 d statement with
c750: 0a 2a 2a 20 62 6f 75 6e 64 20 70 61 72 61 6d 65 .** bound parame
c760: 74 65 72 73 20 65 78 70 61 6e 64 65 64 2e 20 20 ters expanded.
c770: 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 Space to hold th
c780: 65 20 72 65 74 75 72 6e 65 64 20 73 74 72 69 6e e returned strin
c790: 67 20 69 73 0a 2a 2a 20 6f 62 74 61 69 6e 65 64 g is.** obtained
c7a0: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 from sqlite3_ma
c7b0: 6c 6c 6f 63 28 29 2e 20 20 54 68 65 20 63 61 6c lloc(). The cal
c7c0: 6c 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62 ler is responsib
c7d0: 6c 65 20 66 6f 72 0a 2a 2a 20 66 72 65 65 69 6e le for.** freein
c7e0: 67 20 74 68 65 20 72 65 74 75 72 6e 65 64 20 73 g the returned s
c7f0: 74 72 69 6e 67 20 62 79 20 70 61 73 73 69 6e 67 tring by passing
c800: 20 69 74 20 74 6f 20 73 71 6c 69 74 65 33 5f 66 it to sqlite3_f
c810: 72 65 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ree()..**.** The
c820: 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 53 49 SQLITE_TRACE_SI
c830: 5a 45 5f 4c 49 4d 49 54 20 70 75 74 73 20 61 6e ZE_LIMIT puts an
c840: 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 upper bound on
c850: 74 68 65 20 73 69 7a 65 20 6f 66 0a 2a 2a 20 65 the size of.** e
c860: 78 70 61 6e 64 65 64 20 62 6f 75 6e 64 20 70 61 xpanded bound pa
c870: 72 61 6d 65 74 65 72 73 2e 0a 2a 2f 0a 63 68 61 rameters..*/.cha
c880: 72 20 2a 73 71 6c 69 74 65 33 5f 65 78 70 61 6e r *sqlite3_expan
c890: 64 65 64 5f 73 71 6c 28 73 71 6c 69 74 65 33 5f ded_sql(sqlite3_
c8a0: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 23 69 stmt *pStmt){.#i
c8b0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
c8c0: 5f 54 52 41 43 45 0a 20 20 72 65 74 75 72 6e 20 _TRACE. return
c8d0: 30 3b 0a 23 65 6c 73 65 0a 20 20 63 68 61 72 20 0;.#else. char
c8e0: 2a 7a 20 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20 *z = 0;. const
c8f0: 63 68 61 72 20 2a 7a 53 71 6c 20 3d 20 73 71 6c char *zSql = sql
c900: 69 74 65 33 5f 73 71 6c 28 70 53 74 6d 74 29 3b ite3_sql(pStmt);
c910: 0a 20 20 69 66 28 20 7a 53 71 6c 20 29 7b 0a 20 . if( zSql ){.
c920: 20 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 Vdbe *p = (Vd
c930: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20 be *)pStmt;.
c940: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
c950: 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 ter(p->db->mutex
c960: 29 3b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 );. z = sqlit
c970: 65 33 56 64 62 65 45 78 70 61 6e 64 53 71 6c 28 e3VdbeExpandSql(
c980: 70 2c 20 7a 53 71 6c 29 3b 0a 20 20 20 20 73 71 p, zSql);. sq
c990: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
c9a0: 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b e(p->db->mutex);
c9b0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b . }. return z;
c9c0: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 23 69 66 64 65 .#endif.}..#ifde
c9d0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
c9e0: 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 2f PREUPDATE_HOOK./
c9f0: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e *.** Allocate an
ca00: 64 20 70 6f 70 75 6c 61 74 65 20 61 6e 20 55 6e d populate an Un
ca10: 70 61 63 6b 65 64 52 65 63 6f 72 64 20 73 74 72 packedRecord str
ca20: 75 63 74 75 72 65 20 62 61 73 65 64 20 6f 6e 20 ucture based on
ca30: 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64 0a 2a the serialized.*
ca40: 2a 20 72 65 63 6f 72 64 20 69 6e 20 6e 4b 65 79 * record in nKey
ca50: 2f 70 4b 65 79 2e 20 52 65 74 75 72 6e 20 61 20 /pKey. Return a
ca60: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e pointer to the n
ca70: 65 77 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 ew UnpackedRecor
ca80: 64 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 69 d structure.** i
ca90: 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 f successful, or
caa0: 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 20 a NULL pointer
cab0: 69 66 20 61 6e 20 4f 4f 4d 20 65 72 72 6f 72 20 if an OOM error
cac0: 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2e 0a is encountered..
cad0: 2a 2f 0a 73 74 61 74 69 63 20 55 6e 70 61 63 6b */.static Unpack
cae0: 65 64 52 65 63 6f 72 64 20 2a 76 64 62 65 55 6e edRecord *vdbeUn
caf0: 70 61 63 6b 52 65 63 6f 72 64 28 0a 20 20 4b 65 packRecord(. Ke
cb00: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c yInfo *pKeyInfo,
cb10: 20 0a 20 20 69 6e 74 20 6e 4b 65 79 2c 20 0a 20 . int nKey, .
cb20: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
cb30: 79 0a 29 7b 0a 20 20 55 6e 70 61 63 6b 65 64 52 y.){. UnpackedR
cb40: 65 63 6f 72 64 20 2a 70 52 65 74 3b 20 20 20 20 ecord *pRet;
cb50: 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
cb60: 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 20 70 52 65 value */.. pRe
cb70: 74 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 t = sqlite3VdbeA
cb80: 6c 6c 6f 63 55 6e 70 61 63 6b 65 64 52 65 63 6f llocUnpackedReco
cb90: 72 64 28 70 4b 65 79 49 6e 66 6f 29 3b 0a 20 20 rd(pKeyInfo);.
cba0: 69 66 28 20 70 52 65 74 20 29 7b 0a 20 20 20 20 if( pRet ){.
cbb0: 6d 65 6d 73 65 74 28 70 52 65 74 2d 3e 61 4d 65 memset(pRet->aMe
cbc0: 6d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4d 65 6d m, 0, sizeof(Mem
cbd0: 29 2a 28 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 )*(pKeyInfo->nFi
cbe0: 65 6c 64 2b 31 29 29 3b 0a 20 20 20 20 73 71 6c eld+1));. sql
cbf0: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 55 6e ite3VdbeRecordUn
cc00: 70 61 63 6b 28 70 4b 65 79 49 6e 66 6f 2c 20 6e pack(pKeyInfo, n
cc10: 4b 65 79 2c 20 70 4b 65 79 2c 20 70 52 65 74 29 Key, pKey, pRet)
cc20: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 ;. }. return p
cc30: 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 Ret;.}../*.** Th
cc40: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
cc50: 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 alled from withi
cc60: 6e 20 61 20 70 72 65 2d 75 70 64 61 74 65 20 63 n a pre-update c
cc70: 61 6c 6c 62 61 63 6b 20 74 6f 20 72 65 74 72 69 allback to retri
cc80: 65 76 65 0a 2a 2a 20 61 20 66 69 65 6c 64 20 6f eve.** a field o
cc90: 66 20 74 68 65 20 72 6f 77 20 63 75 72 72 65 6e f the row curren
cca0: 74 6c 79 20 62 65 69 6e 67 20 75 70 64 61 74 65 tly being update
ccb0: 64 20 6f 72 20 64 65 6c 65 74 65 64 2e 0a 2a 2f d or deleted..*/
ccc0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 .int sqlite3_pre
ccd0: 75 70 64 61 74 65 5f 6f 6c 64 28 73 71 6c 69 74 update_old(sqlit
cce0: 65 33 20 2a 64 62 2c 20 69 6e 74 20 69 49 64 78 e3 *db, int iIdx
ccf0: 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 , sqlite3_value
cd00: 2a 2a 70 70 56 61 6c 75 65 29 7b 0a 20 20 50 72 **ppValue){. Pr
cd10: 65 55 70 64 61 74 65 20 2a 70 20 3d 20 64 62 2d eUpdate *p = db-
cd20: 3e 70 50 72 65 55 70 64 61 74 65 3b 0a 20 20 4d >pPreUpdate;. M
cd30: 65 6d 20 2a 70 4d 65 6d 3b 0a 20 20 69 6e 74 20 em *pMem;. int
cd40: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
cd50: 0a 20 20 2f 2a 20 54 65 73 74 20 74 68 61 74 20 . /* Test that
cd60: 74 68 69 73 20 63 61 6c 6c 20 69 73 20 62 65 69 this call is bei
cd70: 6e 67 20 6d 61 64 65 20 66 72 6f 6d 20 77 69 74 ng made from wit
cd80: 68 69 6e 20 61 6e 20 53 51 4c 49 54 45 5f 44 45 hin an SQLITE_DE
cd90: 4c 45 54 45 20 6f 72 0a 20 20 2a 2a 20 53 51 4c LETE or. ** SQL
cda0: 49 54 45 5f 55 50 44 41 54 45 20 70 72 65 2d 75 ITE_UPDATE pre-u
cdb0: 70 64 61 74 65 20 63 61 6c 6c 62 61 63 6b 2c 20 pdate callback,
cdc0: 61 6e 64 20 74 68 61 74 20 69 49 64 78 20 69 73 and that iIdx is
cdd0: 20 77 69 74 68 69 6e 20 72 61 6e 67 65 2e 20 2a within range. *
cde0: 2f 0a 20 20 69 66 28 20 21 70 20 7c 7c 20 70 2d /. if( !p || p-
cdf0: 3e 6f 70 3d 3d 53 51 4c 49 54 45 5f 49 4e 53 45 >op==SQLITE_INSE
ce00: 52 54 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 RT ){. rc = S
ce10: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
ce20: 54 3b 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 75 T;. goto preu
ce30: 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 3b 0a 20 pdate_old_out;.
ce40: 20 7d 0a 20 20 69 66 28 20 70 2d 3e 70 50 6b 20 }. if( p->pPk
ce50: 29 7b 0a 20 20 20 20 69 49 64 78 20 3d 20 73 71 ){. iIdx = sq
ce60: 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 lite3ColumnOfInd
ce70: 65 78 28 70 2d 3e 70 50 6b 2c 20 69 49 64 78 29 ex(p->pPk, iIdx)
ce80: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 49 64 78 ;. }. if( iIdx
ce90: 3e 3d 70 2d 3e 70 43 73 72 2d 3e 6e 46 69 65 6c >=p->pCsr->nFiel
cea0: 64 20 7c 7c 20 69 49 64 78 3c 30 20 29 7b 0a 20 d || iIdx<0 ){.
ceb0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 rc = SQLITE_R
cec0: 41 4e 47 45 3b 0a 20 20 20 20 67 6f 74 6f 20 70 ANGE;. goto p
ced0: 72 65 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 reupdate_old_out
cee0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 ;. }.. /* If t
cef0: 68 65 20 6f 6c 64 2e 2a 20 72 65 63 6f 72 64 20 he old.* record
cf00: 68 61 73 20 6e 6f 74 20 79 65 74 20 62 65 65 6e has not yet been
cf10: 20 6c 6f 61 64 65 64 20 69 6e 74 6f 20 6d 65 6d loaded into mem
cf20: 6f 72 79 2c 20 64 6f 20 73 6f 20 6e 6f 77 2e 20 ory, do so now.
cf30: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 55 6e 70 */. if( p->pUnp
cf40: 61 63 6b 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 acked==0 ){.
cf50: 75 33 32 20 6e 52 65 63 3b 0a 20 20 20 20 75 38 u32 nRec;. u8
cf60: 20 2a 61 52 65 63 3b 0a 0a 20 20 20 20 6e 52 65 *aRec;.. nRe
cf70: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
cf80: 50 61 79 6c 6f 61 64 53 69 7a 65 28 70 2d 3e 70 PayloadSize(p->p
cf90: 43 73 72 2d 3e 75 63 2e 70 43 75 72 73 6f 72 29 Csr->uc.pCursor)
cfa0: 3b 0a 20 20 20 20 61 52 65 63 20 3d 20 73 71 6c ;. aRec = sql
cfb0: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 ite3DbMallocRaw(
cfc0: 64 62 2c 20 6e 52 65 63 29 3b 0a 20 20 20 20 69 db, nRec);. i
cfd0: 66 28 20 21 61 52 65 63 20 29 20 67 6f 74 6f 20 f( !aRec ) goto
cfe0: 70 72 65 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 preupdate_old_ou
cff0: 74 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 t;. rc = sqli
d000: 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 te3BtreePayload(
d010: 70 2d 3e 70 43 73 72 2d 3e 75 63 2e 70 43 75 72 p->pCsr->uc.pCur
d020: 73 6f 72 2c 20 30 2c 20 6e 52 65 63 2c 20 61 52 sor, 0, nRec, aR
d030: 65 63 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d ec);. if( rc=
d040: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
d050: 20 20 20 20 70 2d 3e 70 55 6e 70 61 63 6b 65 64 p->pUnpacked
d060: 20 3d 20 76 64 62 65 55 6e 70 61 63 6b 52 65 63 = vdbeUnpackRec
d070: 6f 72 64 28 26 70 2d 3e 6b 65 79 69 6e 66 6f 2c ord(&p->keyinfo,
d080: 20 6e 52 65 63 2c 20 61 52 65 63 29 3b 0a 20 20 nRec, aRec);.
d090: 20 20 20 20 69 66 28 20 21 70 2d 3e 70 55 6e 70 if( !p->pUnp
d0a0: 61 63 6b 65 64 20 29 20 72 63 20 3d 20 53 51 4c acked ) rc = SQL
d0b0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d ITE_NOMEM;. }
d0c0: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
d0d0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
d0e0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
d0f0: 2c 20 61 52 65 63 29 3b 0a 20 20 20 20 20 20 67 , aRec);. g
d100: 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6f 6c oto preupdate_ol
d110: 64 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 d_out;. }.
d120: 20 70 2d 3e 61 52 65 63 6f 72 64 20 3d 20 61 52 p->aRecord = aR
d130: 65 63 3b 0a 20 20 7d 0a 0a 20 20 70 4d 65 6d 20 ec;. }.. pMem
d140: 3d 20 2a 70 70 56 61 6c 75 65 20 3d 20 26 70 2d = *ppValue = &p-
d150: 3e 70 55 6e 70 61 63 6b 65 64 2d 3e 61 4d 65 6d >pUnpacked->aMem
d160: 5b 69 49 64 78 5d 3b 0a 20 20 69 66 28 20 69 49 [iIdx];. if( iI
d170: 64 78 3d 3d 70 2d 3e 70 54 61 62 2d 3e 69 50 4b dx==p->pTab->iPK
d180: 65 79 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ey ){. sqlite
d190: 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 3VdbeMemSetInt64
d1a0: 28 70 4d 65 6d 2c 20 70 2d 3e 69 4b 65 79 31 29 (pMem, p->iKey1)
d1b0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 49 ;. }else if( iI
d1c0: 64 78 3e 3d 70 2d 3e 70 55 6e 70 61 63 6b 65 64 dx>=p->pUnpacked
d1d0: 2d 3e 6e 46 69 65 6c 64 20 29 7b 0a 20 20 20 20 ->nField ){.
d1e0: 2a 70 70 56 61 6c 75 65 20 3d 20 28 73 71 6c 69 *ppValue = (sqli
d1f0: 74 65 33 5f 76 61 6c 75 65 20 2a 29 63 6f 6c 75 te3_value *)colu
d200: 6d 6e 4e 75 6c 6c 56 61 6c 75 65 28 29 3b 0a 20 mnNullValue();.
d210: 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 70 54 }else if( p->pT
d220: 61 62 2d 3e 61 43 6f 6c 5b 69 49 64 78 5d 2e 61 ab->aCol[iIdx].a
d230: 66 66 69 6e 69 74 79 3d 3d 53 51 4c 49 54 45 5f ffinity==SQLITE_
d240: 41 46 46 5f 52 45 41 4c 20 29 7b 0a 20 20 20 20 AFF_REAL ){.
d250: 69 66 28 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 if( pMem->flags
d260: 26 20 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20 20 20 & MEM_Int ){.
d270: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 sqlite3VdbeMe
d280: 6d 52 65 61 6c 69 66 79 28 70 4d 65 6d 29 3b 0a mRealify(pMem);.
d290: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 70 72 65 75 }. }.. preu
d2a0: 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 3a 0a 20 pdate_old_out:.
d2b0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
d2c0: 2c 20 72 63 29 3b 0a 20 20 72 65 74 75 72 6e 20 , rc);. return
d2d0: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
d2e0: 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 b, rc);.}.#endif
d2f0: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
d300: 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b E_PREUPDATE_HOOK
d310: 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 */..#ifdef SQLI
d320: 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 44 TE_ENABLE_PREUPD
d330: 41 54 45 5f 48 4f 4f 4b 0a 2f 2a 0a 2a 2a 20 54 ATE_HOOK./*.** T
d340: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
d350: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 called from with
d360: 69 6e 20 61 20 70 72 65 2d 75 70 64 61 74 65 20 in a pre-update
d370: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 72 65 74 72 callback to retr
d380: 69 65 76 65 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 ieve.** the numb
d390: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e er of columns in
d3a0: 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67 20 75 the row being u
d3b0: 70 64 61 74 65 64 2c 20 64 65 6c 65 74 65 64 20 pdated, deleted
d3c0: 6f 72 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2f 0a or inserted..*/.
d3d0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 75 int sqlite3_preu
d3e0: 70 64 61 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 pdate_count(sqli
d3f0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 50 72 65 55 te3 *db){. PreU
d400: 70 64 61 74 65 20 2a 70 20 3d 20 64 62 2d 3e 70 pdate *p = db->p
d410: 50 72 65 55 70 64 61 74 65 3b 0a 20 20 72 65 74 PreUpdate;. ret
d420: 75 72 6e 20 28 70 20 3f 20 70 2d 3e 6b 65 79 69 urn (p ? p->keyi
d430: 6e 66 6f 2e 6e 46 69 65 6c 64 20 3a 20 30 29 3b nfo.nField : 0);
d440: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
d450: 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 ITE_ENABLE_PREUP
d460: 44 41 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 DATE_HOOK */..#i
d470: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
d480: 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f LE_PREUPDATE_HOO
d490: 4b 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e K./*.** This fun
d4a0: 63 74 69 6f 6e 20 69 73 20 64 65 73 69 67 6e 65 ction is designe
d4b0: 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 66 d to be called f
d4c0: 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 70 72 65 rom within a pre
d4d0: 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 6b -update callback
d4e0: 0a 2a 2a 20 6f 6e 6c 79 2e 20 49 74 20 72 65 74 .** only. It ret
d4f0: 75 72 6e 73 20 7a 65 72 6f 20 69 66 20 74 68 65 urns zero if the
d500: 20 63 68 61 6e 67 65 20 74 68 61 74 20 63 61 75 change that cau
d510: 73 65 64 20 74 68 65 20 63 61 6c 6c 62 61 63 6b sed the callback
d520: 20 77 61 73 20 6d 61 64 65 0a 2a 2a 20 69 6d 6d was made.** imm
d530: 65 64 69 61 74 65 6c 79 20 62 79 20 61 20 75 73 ediately by a us
d540: 65 72 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 er SQL statement
d550: 2e 20 4f 72 2c 20 69 66 20 74 68 65 20 63 68 61 . Or, if the cha
d560: 6e 67 65 20 77 61 73 20 6d 61 64 65 20 62 79 20 nge was made by
d570: 61 0a 2a 2a 20 74 72 69 67 67 65 72 20 70 72 6f a.** trigger pro
d580: 67 72 61 6d 2c 20 69 74 20 72 65 74 75 72 6e 73 gram, it returns
d590: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 the number of t
d5a0: 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 73 20 rigger programs
d5b0: 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 6f 6e 20 currently.** on
d5c0: 74 68 65 20 73 74 61 63 6b 20 28 31 20 66 6f 72 the stack (1 for
d5d0: 20 61 20 74 6f 70 2d 6c 65 76 65 6c 20 74 72 69 a top-level tri
d5e0: 67 67 65 72 2c 20 32 20 66 6f 72 20 61 20 74 72 gger, 2 for a tr
d5f0: 69 67 67 65 72 20 66 69 72 65 64 20 62 79 20 61 igger fired by a
d600: 20 0a 2a 2a 20 74 6f 70 2d 6c 65 76 65 6c 20 74 .** top-level t
d610: 72 69 67 67 65 72 20 65 74 63 2e 29 2e 0a 2a 2a rigger etc.)..**
d620: 0a 2a 2a 20 46 6f 72 20 74 68 65 20 70 75 72 70 .** For the purp
d630: 6f 73 65 73 20 6f 66 20 74 68 65 20 70 72 65 76 oses of the prev
d640: 69 6f 75 73 20 70 61 72 61 67 72 61 70 68 2c 20 ious paragraph,
d650: 61 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 43 41 a foreign key CA
d660: 53 43 41 44 45 2c 20 53 45 54 20 4e 55 4c 4c 0a SCADE, SET NULL.
d670: 2a 2a 20 6f 72 20 53 45 54 20 44 45 46 41 55 4c ** or SET DEFAUL
d680: 54 20 61 63 74 69 6f 6e 20 69 73 20 63 6f 6e 73 T action is cons
d690: 69 64 65 72 65 64 20 61 20 74 72 69 67 67 65 72 idered a trigger
d6a0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
d6b0: 5f 70 72 65 75 70 64 61 74 65 5f 64 65 70 74 68 _preupdate_depth
d6c0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 (sqlite3 *db){.
d6d0: 20 50 72 65 55 70 64 61 74 65 20 2a 70 20 3d 20 PreUpdate *p =
d6e0: 64 62 2d 3e 70 50 72 65 55 70 64 61 74 65 3b 0a db->pPreUpdate;.
d6f0: 20 20 72 65 74 75 72 6e 20 28 70 20 3f 20 70 2d return (p ? p-
d700: 3e 76 2d 3e 6e 46 72 61 6d 65 20 3a 20 30 29 3b >v->nFrame : 0);
d710: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
d720: 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 ITE_ENABLE_PREUP
d730: 44 41 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 DATE_HOOK */..#i
d740: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
d750: 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f LE_PREUPDATE_HOO
d760: 4b 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e K./*.** This fun
d770: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
d780: 66 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 70 72 from within a pr
d790: 65 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 e-update callbac
d7a0: 6b 20 74 6f 20 72 65 74 72 69 65 76 65 0a 2a 2a k to retrieve.**
d7b0: 20 61 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 a field of the
d7c0: 72 6f 77 20 63 75 72 72 65 6e 74 6c 79 20 62 65 row currently be
d7d0: 69 6e 67 20 75 70 64 61 74 65 64 20 6f 72 20 69 ing updated or i
d7e0: 6e 73 65 72 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 nserted..*/.int
d7f0: 73 71 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 sqlite3_preupdat
d800: 65 5f 6e 65 77 28 73 71 6c 69 74 65 33 20 2a 64 e_new(sqlite3 *d
d810: 62 2c 20 69 6e 74 20 69 49 64 78 2c 20 73 71 6c b, int iIdx, sql
d820: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 70 70 56 ite3_value **ppV
d830: 61 6c 75 65 29 7b 0a 20 20 50 72 65 55 70 64 61 alue){. PreUpda
d840: 74 65 20 2a 70 20 3d 20 64 62 2d 3e 70 50 72 65 te *p = db->pPre
d850: 55 70 64 61 74 65 3b 0a 20 20 69 6e 74 20 72 63 Update;. int rc
d860: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
d870: 4d 65 6d 20 2a 70 4d 65 6d 3b 0a 0a 20 20 69 66 Mem *pMem;.. if
d880: 28 20 21 70 20 7c 7c 20 70 2d 3e 6f 70 3d 3d 53 ( !p || p->op==S
d890: 51 4c 49 54 45 5f 44 45 4c 45 54 45 20 29 7b 0a QLITE_DELETE ){.
d8a0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
d8b0: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
d8c0: 20 67 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f goto preupdate_
d8d0: 6e 65 77 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 new_out;. }. i
d8e0: 66 28 20 70 2d 3e 70 50 6b 20 26 26 20 70 2d 3e f( p->pPk && p->
d8f0: 6f 70 21 3d 53 51 4c 49 54 45 5f 55 50 44 41 54 op!=SQLITE_UPDAT
d900: 45 20 29 7b 0a 20 20 20 20 69 49 64 78 20 3d 20 E ){. iIdx =
d910: 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 sqlite3ColumnOfI
d920: 6e 64 65 78 28 70 2d 3e 70 50 6b 2c 20 69 49 64 ndex(p->pPk, iId
d930: 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 49 x);. }. if( iI
d940: 64 78 3e 3d 70 2d 3e 70 43 73 72 2d 3e 6e 46 69 dx>=p->pCsr->nFi
d950: 65 6c 64 20 7c 7c 20 69 49 64 78 3c 30 20 29 7b eld || iIdx<0 ){
d960: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
d970: 5f 52 41 4e 47 45 3b 0a 20 20 20 20 67 6f 74 6f _RANGE;. goto
d980: 20 70 72 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f preupdate_new_o
d990: 75 74 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 ut;. }.. if( p
d9a0: 2d 3e 6f 70 3d 3d 53 51 4c 49 54 45 5f 49 4e 53 ->op==SQLITE_INS
d9b0: 45 52 54 20 29 7b 0a 20 20 20 20 2f 2a 20 46 6f ERT ){. /* Fo
d9c0: 72 20 61 6e 20 49 4e 53 45 52 54 2c 20 6d 65 6d r an INSERT, mem
d9d0: 6f 72 79 20 63 65 6c 6c 20 70 2d 3e 69 4e 65 77 ory cell p->iNew
d9e0: 52 65 67 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 Reg contains the
d9f0: 20 73 65 72 69 61 6c 69 7a 65 64 20 72 65 63 6f serialized reco
da00: 72 64 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 69 rd. ** that i
da10: 73 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65 64 s being inserted
da20: 2e 20 44 65 73 65 72 69 61 6c 69 7a 65 20 69 74 . Deserialize it
da30: 2e 20 2a 2f 0a 20 20 20 20 55 6e 70 61 63 6b 65 . */. Unpacke
da40: 64 52 65 63 6f 72 64 20 2a 70 55 6e 70 61 63 6b dRecord *pUnpack
da50: 20 3d 20 70 2d 3e 70 4e 65 77 55 6e 70 61 63 6b = p->pNewUnpack
da60: 65 64 3b 0a 20 20 20 20 69 66 28 20 21 70 55 6e ed;. if( !pUn
da70: 70 61 63 6b 20 29 7b 0a 20 20 20 20 20 20 4d 65 pack ){. Me
da80: 6d 20 2a 70 44 61 74 61 20 3d 20 26 70 2d 3e 76 m *pData = &p->v
da90: 2d 3e 61 4d 65 6d 5b 70 2d 3e 69 4e 65 77 52 65 ->aMem[p->iNewRe
daa0: 67 5d 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 45 g];. rc = E
dab0: 78 70 61 6e 64 42 6c 6f 62 28 70 44 61 74 61 29 xpandBlob(pData)
dac0: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
dad0: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f SQLITE_OK ) goto
dae0: 20 70 72 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f preupdate_new_o
daf0: 75 74 3b 0a 20 20 20 20 20 20 70 55 6e 70 61 63 ut;. pUnpac
db00: 6b 20 3d 20 76 64 62 65 55 6e 70 61 63 6b 52 65 k = vdbeUnpackRe
db10: 63 6f 72 64 28 26 70 2d 3e 6b 65 79 69 6e 66 6f cord(&p->keyinfo
db20: 2c 20 70 44 61 74 61 2d 3e 6e 2c 20 70 44 61 74 , pData->n, pDat
db30: 61 2d 3e 7a 29 3b 0a 20 20 20 20 20 20 69 66 28 a->z);. if(
db40: 20 21 70 55 6e 70 61 63 6b 20 29 7b 0a 20 20 20 !pUnpack ){.
db50: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
db60: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20 _NOMEM;.
db70: 67 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6e goto preupdate_n
db80: 65 77 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a ew_out;. }.
db90: 20 20 20 20 20 20 70 2d 3e 70 4e 65 77 55 6e 70 p->pNewUnp
dba0: 61 63 6b 65 64 20 3d 20 70 55 6e 70 61 63 6b 3b acked = pUnpack;
dbb0: 0a 20 20 20 20 7d 0a 20 20 20 20 70 4d 65 6d 20 . }. pMem
dbc0: 3d 20 26 70 55 6e 70 61 63 6b 2d 3e 61 4d 65 6d = &pUnpack->aMem
dbd0: 5b 69 49 64 78 5d 3b 0a 20 20 20 20 69 66 28 20 [iIdx];. if(
dbe0: 69 49 64 78 3d 3d 70 2d 3e 70 54 61 62 2d 3e 69 iIdx==p->pTab->i
dbf0: 50 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 73 71 PKey ){. sq
dc00: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 lite3VdbeMemSetI
dc10: 6e 74 36 34 28 70 4d 65 6d 2c 20 70 2d 3e 69 4b nt64(pMem, p->iK
dc20: 65 79 32 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 ey2);. }else
dc30: 69 66 28 20 69 49 64 78 3e 3d 70 55 6e 70 61 63 if( iIdx>=pUnpac
dc40: 6b 2d 3e 6e 46 69 65 6c 64 20 29 7b 0a 20 20 20 k->nField ){.
dc50: 20 20 20 70 4d 65 6d 20 3d 20 28 73 71 6c 69 74 pMem = (sqlit
dc60: 65 33 5f 76 61 6c 75 65 20 2a 29 63 6f 6c 75 6d e3_value *)colum
dc70: 6e 4e 75 6c 6c 56 61 6c 75 65 28 29 3b 0a 20 20 nNullValue();.
dc80: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
dc90: 20 2f 2a 20 46 6f 72 20 61 6e 20 55 50 44 41 54 /* For an UPDAT
dca0: 45 2c 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 28 E, memory cell (
dcb0: 70 2d 3e 69 4e 65 77 52 65 67 2b 31 2b 69 49 64 p->iNewReg+1+iId
dcc0: 78 29 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 x) contains the
dcd0: 72 65 71 75 69 72 65 64 0a 20 20 20 20 2a 2a 20 required. **
dce0: 76 61 6c 75 65 2e 20 4d 61 6b 65 20 61 20 63 6f value. Make a co
dcf0: 70 79 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 py of the cell c
dd00: 6f 6e 74 65 6e 74 73 20 61 6e 64 20 72 65 74 75 ontents and retu
dd10: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 rn a pointer to
dd20: 69 74 2e 0a 20 20 20 20 2a 2a 20 49 74 20 69 73 it.. ** It is
dd30: 20 6e 6f 74 20 73 61 66 65 20 74 6f 20 72 65 74 not safe to ret
dd40: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f urn a pointer to
dd50: 20 74 68 65 20 6d 65 6d 6f 72 79 20 63 65 6c 6c the memory cell
dd60: 20 69 74 73 65 6c 66 20 61 73 20 74 68 65 0a 20 itself as the.
dd70: 20 20 20 2a 2a 20 63 61 6c 6c 65 72 20 6d 61 79 ** caller may
dd80: 20 6d 6f 64 69 66 79 20 74 68 65 20 76 61 6c 75 modify the valu
dd90: 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e e text encoding.
dda0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 . */. asse
ddb0: 72 74 28 20 70 2d 3e 6f 70 3d 3d 53 51 4c 49 54 rt( p->op==SQLIT
ddc0: 45 5f 55 50 44 41 54 45 20 29 3b 0a 20 20 20 20 E_UPDATE );.
ddd0: 69 66 28 20 21 70 2d 3e 61 4e 65 77 20 29 7b 0a if( !p->aNew ){.
dde0: 20 20 20 20 20 20 70 2d 3e 61 4e 65 77 20 3d 20 p->aNew =
ddf0: 28 4d 65 6d 20 2a 29 73 71 6c 69 74 65 33 44 62 (Mem *)sqlite3Db
de00: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 MallocZero(db, s
de10: 69 7a 65 6f 66 28 4d 65 6d 29 20 2a 20 70 2d 3e izeof(Mem) * p->
de20: 70 43 73 72 2d 3e 6e 46 69 65 6c 64 29 3b 0a 20 pCsr->nField);.
de30: 20 20 20 20 20 69 66 28 20 21 70 2d 3e 61 4e 65 if( !p->aNe
de40: 77 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 w ){. rc
de50: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a = SQLITE_NOMEM;.
de60: 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 72 65 goto pre
de70: 75 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a update_new_out;.
de80: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
de90: 20 20 61 73 73 65 72 74 28 20 69 49 64 78 3e 3d assert( iIdx>=
dea0: 30 20 26 26 20 69 49 64 78 3c 70 2d 3e 70 43 73 0 && iIdx<p->pCs
deb0: 72 2d 3e 6e 46 69 65 6c 64 20 29 3b 0a 20 20 20 r->nField );.
dec0: 20 70 4d 65 6d 20 3d 20 26 70 2d 3e 61 4e 65 77 pMem = &p->aNew
ded0: 5b 69 49 64 78 5d 3b 0a 20 20 20 20 69 66 28 20 [iIdx];. if(
dee0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 3d 3d 30 20 29 pMem->flags==0 )
def0: 7b 0a 20 20 20 20 20 20 69 66 28 20 69 49 64 78 {. if( iIdx
df00: 3d 3d 70 2d 3e 70 54 61 62 2d 3e 69 50 4b 65 79 ==p->pTab->iPKey
df10: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
df20: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 te3VdbeMemSetInt
df30: 36 34 28 70 4d 65 6d 2c 20 70 2d 3e 69 4b 65 79 64(pMem, p->iKey
df40: 32 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 2);. }else{
df50: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
df60: 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 lite3VdbeMemCopy
df70: 28 70 4d 65 6d 2c 20 26 70 2d 3e 76 2d 3e 61 4d (pMem, &p->v->aM
df80: 65 6d 5b 70 2d 3e 69 4e 65 77 52 65 67 2b 31 2b em[p->iNewReg+1+
df90: 69 49 64 78 5d 29 3b 0a 20 20 20 20 20 20 20 20 iIdx]);.
dfa0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
dfb0: 4b 20 29 20 67 6f 74 6f 20 70 72 65 75 70 64 61 K ) goto preupda
dfc0: 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20 20 20 te_new_out;.
dfd0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 }. }. }.
dfe0: 2a 70 70 56 61 6c 75 65 20 3d 20 70 4d 65 6d 3b *ppValue = pMem;
dff0: 0a 0a 20 70 72 65 75 70 64 61 74 65 5f 6e 65 77 .. preupdate_new
e000: 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 45 _out:. sqlite3E
e010: 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 20 rror(db, rc);.
e020: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 return sqlite3Ap
e030: 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 7d iExit(db, rc);.}
e040: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
e050: 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 E_ENABLE_PREUPDA
e060: 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 66 64 TE_HOOK */..#ifd
e070: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
e080: 5f 53 54 4d 54 5f 53 43 41 4e 53 54 41 54 55 53 _STMT_SCANSTATUS
e090: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 73 74 ./*.** Return st
e0a0: 61 74 75 73 20 64 61 74 61 20 66 6f 72 20 61 20 atus data for a
e0b0: 73 69 6e 67 6c 65 20 6c 6f 6f 70 20 77 69 74 68 single loop with
e0c0: 69 6e 20 71 75 65 72 79 20 70 53 74 6d 74 2e 0a in query pStmt..
e0d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 */.int sqlite3_s
e0e0: 74 6d 74 5f 73 63 61 6e 73 74 61 74 75 73 28 0a tmt_scanstatus(.
e0f0: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
e100: 70 53 74 6d 74 2c 20 20 20 20 20 20 20 20 20 20 pStmt,
e110: 20 20 2f 2a 20 50 72 65 70 61 72 65 64 20 73 74 /* Prepared st
e120: 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 20 71 75 atement being qu
e130: 65 72 69 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 eried */. int i
e140: 64 78 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 dx,
e150: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
e160: 64 65 78 20 6f 66 20 6c 6f 6f 70 20 74 6f 20 72 dex of loop to r
e170: 65 70 6f 72 74 20 6f 6e 20 2a 2f 0a 20 20 69 6e eport on */. in
e180: 74 20 69 53 63 61 6e 53 74 61 74 75 73 4f 70 2c t iScanStatusOp,
e190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
e1a0: 20 57 68 69 63 68 20 6d 65 74 72 69 63 20 74 6f Which metric to
e1b0: 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 76 6f 69 return */. voi
e1c0: 64 20 2a 70 4f 75 74 20 20 20 20 20 20 20 20 20 d *pOut
e1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
e1e0: 4f 55 54 3a 20 57 72 69 74 65 20 74 68 65 20 61 OUT: Write the a
e1f0: 6e 73 77 65 72 20 68 65 72 65 20 2a 2f 0a 29 7b nswer here */.){
e200: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 . Vdbe *p = (Vd
e210: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 53 63 61 be*)pStmt;. Sca
e220: 6e 53 74 61 74 75 73 20 2a 70 53 63 61 6e 3b 0a nStatus *pScan;.
e230: 20 20 69 66 28 20 69 64 78 3c 30 20 7c 7c 20 69 if( idx<0 || i
e240: 64 78 3e 3d 70 2d 3e 6e 53 63 61 6e 20 29 20 72 dx>=p->nScan ) r
e250: 65 74 75 72 6e 20 31 3b 0a 20 20 70 53 63 61 6e eturn 1;. pScan
e260: 20 3d 20 26 70 2d 3e 61 53 63 61 6e 5b 69 64 78 = &p->aScan[idx
e270: 5d 3b 0a 20 20 73 77 69 74 63 68 28 20 69 53 63 ];. switch( iSc
e280: 61 6e 53 74 61 74 75 73 4f 70 20 29 7b 0a 20 20 anStatusOp ){.
e290: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 case SQLITE_SC
e2a0: 41 4e 53 54 41 54 5f 4e 4c 4f 4f 50 3a 20 7b 0a ANSTAT_NLOOP: {.
e2b0: 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 33 5f *(sqlite3_
e2c0: 69 6e 74 36 34 2a 29 70 4f 75 74 20 3d 20 70 2d int64*)pOut = p-
e2d0: 3e 61 6e 45 78 65 63 5b 70 53 63 61 6e 2d 3e 61 >anExec[pScan->a
e2e0: 64 64 72 4c 6f 6f 70 5d 3b 0a 20 20 20 20 20 20 ddrLoop];.
e2f0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
e300: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 41 case SQLITE_SCA
e310: 4e 53 54 41 54 5f 4e 56 49 53 49 54 3a 20 7b 0a NSTAT_NVISIT: {.
e320: 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 33 5f *(sqlite3_
e330: 69 6e 74 36 34 2a 29 70 4f 75 74 20 3d 20 70 2d int64*)pOut = p-
e340: 3e 61 6e 45 78 65 63 5b 70 53 63 61 6e 2d 3e 61 >anExec[pScan->a
e350: 64 64 72 56 69 73 69 74 5d 3b 0a 20 20 20 20 20 ddrVisit];.
e360: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
e370: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 case SQLITE_SC
e380: 41 4e 53 54 41 54 5f 45 53 54 3a 20 7b 0a 20 20 ANSTAT_EST: {.
e390: 20 20 20 20 64 6f 75 62 6c 65 20 72 20 3d 20 31 double r = 1
e3a0: 2e 30 3b 0a 20 20 20 20 20 20 4c 6f 67 45 73 74 .0;. LogEst
e3b0: 20 78 20 3d 20 70 53 63 61 6e 2d 3e 6e 45 73 74 x = pScan->nEst
e3c0: 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 78 ;. while( x
e3d0: 3c 31 30 30 20 29 7b 0a 20 20 20 20 20 20 20 20 <100 ){.
e3e0: 78 20 2b 3d 20 31 30 3b 0a 20 20 20 20 20 20 20 x += 10;.
e3f0: 20 72 20 2a 3d 20 30 2e 35 3b 0a 20 20 20 20 20 r *= 0.5;.
e400: 20 7d 0a 20 20 20 20 20 20 2a 28 64 6f 75 62 6c }. *(doubl
e410: 65 2a 29 70 4f 75 74 20 3d 20 72 2a 73 71 6c 69 e*)pOut = r*sqli
e420: 74 65 33 4c 6f 67 45 73 74 54 6f 49 6e 74 28 78 te3LogEstToInt(x
e430: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
e440: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 }. case S
e450: 51 4c 49 54 45 5f 53 43 41 4e 53 54 41 54 5f 4e QLITE_SCANSTAT_N
e460: 41 4d 45 3a 20 7b 0a 20 20 20 20 20 20 2a 28 63 AME: {. *(c
e470: 6f 6e 73 74 20 63 68 61 72 2a 2a 29 70 4f 75 74 onst char**)pOut
e480: 20 3d 20 70 53 63 61 6e 2d 3e 7a 4e 61 6d 65 3b = pScan->zName;
e490: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
e4a0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
e4b0: 49 54 45 5f 53 43 41 4e 53 54 41 54 5f 45 58 50 ITE_SCANSTAT_EXP
e4c0: 4c 41 49 4e 3a 20 7b 0a 20 20 20 20 20 20 69 66 LAIN: {. if
e4d0: 28 20 70 53 63 61 6e 2d 3e 61 64 64 72 45 78 70 ( pScan->addrExp
e4e0: 6c 61 69 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 lain ){.
e4f0: 2a 28 63 6f 6e 73 74 20 63 68 61 72 2a 2a 29 70 *(const char**)p
e500: 4f 75 74 20 3d 20 70 2d 3e 61 4f 70 5b 20 70 53 Out = p->aOp[ pS
e510: 63 61 6e 2d 3e 61 64 64 72 45 78 70 6c 61 69 6e can->addrExplain
e520: 20 5d 2e 70 34 2e 7a 3b 0a 20 20 20 20 20 20 7d ].p4.z;. }
e530: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2a 28 else{. *(
e540: 63 6f 6e 73 74 20 63 68 61 72 2a 2a 29 70 4f 75 const char**)pOu
e550: 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 t = 0;. }.
e560: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
e570: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
e580: 45 5f 53 43 41 4e 53 54 41 54 5f 53 45 4c 45 43 E_SCANSTAT_SELEC
e590: 54 49 44 3a 20 7b 0a 20 20 20 20 20 20 69 66 28 TID: {. if(
e5a0: 20 70 53 63 61 6e 2d 3e 61 64 64 72 45 78 70 6c pScan->addrExpl
e5b0: 61 69 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 2a ain ){. *
e5c0: 28 69 6e 74 2a 29 70 4f 75 74 20 3d 20 70 2d 3e (int*)pOut = p->
e5d0: 61 4f 70 5b 20 70 53 63 61 6e 2d 3e 61 64 64 72 aOp[ pScan->addr
e5e0: 45 78 70 6c 61 69 6e 20 5d 2e 70 31 3b 0a 20 20 Explain ].p1;.
e5f0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
e600: 20 20 20 2a 28 69 6e 74 2a 29 70 4f 75 74 20 3d *(int*)pOut =
e610: 20 2d 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 -1;. }.
e620: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
e630: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 default: {.
e640: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 return 1;.
e650: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
e660: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 5a 65 n 0;.}../*.** Ze
e670: 72 6f 20 61 6c 6c 20 63 6f 75 6e 74 65 72 73 20 ro all counters
e680: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
e690: 74 68 65 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 the sqlite3_stmt
e6a0: 5f 73 63 61 6e 73 74 61 74 75 73 28 29 20 64 61 _scanstatus() da
e6b0: 74 61 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ta..*/.void sqli
e6c0: 74 65 33 5f 73 74 6d 74 5f 73 63 61 6e 73 74 61 te3_stmt_scansta
e6d0: 74 75 73 5f 72 65 73 65 74 28 73 71 6c 69 74 65 tus_reset(sqlite
e6e0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 3_stmt *pStmt){.
e6f0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 Vdbe *p = (Vdb
e700: 65 2a 29 70 53 74 6d 74 3b 0a 20 20 6d 65 6d 73 e*)pStmt;. mems
e710: 65 74 28 70 2d 3e 61 6e 45 78 65 63 2c 20 30 2c et(p->anExec, 0,
e720: 20 70 2d 3e 6e 4f 70 20 2a 20 73 69 7a 65 6f 66 p->nOp * sizeof
e730: 28 69 36 34 29 29 3b 0a 7d 0a 23 65 6e 64 69 66 (i64));.}.#endif
e740: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
e750: 45 5f 53 54 4d 54 5f 53 43 41 4e 53 54 41 54 55 E_STMT_SCANSTATU
e760: 53 20 2a 2f 0a S */.