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 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 ".#include "os.h
0200: 22 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 "../*.** Return
0210: 54 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 TRUE (non-zero)
0220: 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 of the statement
0230: 20 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20 supplied as an
0240: 61 72 67 75 6d 65 6e 74 20 6e 65 65 64 73 0a 2a argument needs.*
0250: 2a 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c * to be recompil
0260: 65 64 2e 20 20 41 20 73 74 61 74 65 6d 65 6e 74 ed. A statement
0270: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 63 needs to be rec
0280: 6f 6d 70 69 6c 65 64 20 77 68 65 6e 65 76 65 72 ompiled whenever
0290: 20 74 68 65 0a 2a 2a 20 65 78 65 63 75 74 69 6f the.** executio
02a0: 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 63 68 n environment ch
02b0: 61 6e 67 65 73 20 69 6e 20 61 20 77 61 79 20 74 anges in a way t
02c0: 68 61 74 20 77 6f 75 6c 64 20 61 6c 74 65 72 20 hat would alter
02d0: 74 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 74 the program.** t
02e0: 68 61 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 hat sqlite3_prep
02f0: 61 72 65 28 29 20 67 65 6e 65 72 61 74 65 73 2e are() generates.
0300: 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 For example, i
0310: 66 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 73 20 f new functions
0320: 6f 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 or.** collating
0330: 73 65 71 75 65 6e 63 65 73 20 61 72 65 20 72 65 sequences are re
0340: 67 69 73 74 65 72 65 64 20 6f 72 20 69 66 20 61 gistered or if a
0350: 6e 20 61 75 74 68 6f 72 69 7a 65 72 20 66 75 6e n authorizer fun
0360: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64 64 65 ction is.** adde
0370: 64 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a 2a 2f d or changed..*/
0380: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 70 .int sqlite3_exp
0390: 69 72 65 64 28 73 71 6c 69 74 65 33 5f 73 74 6d ired(sqlite3_stm
03a0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 t *pStmt){. Vdb
03b0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 e *p = (Vdbe*)pS
03c0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 3d tmt;. return p=
03d0: 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72 65 64 =0 || p->expired
03e0: 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ;.}../**********
03f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0400: 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 ** sqlite3_value
0410: 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a _ *************
0420: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0430: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 **.** The follow
0440: 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 65 78 74 ing routines ext
0450: 72 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ract information
0460: 20 66 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20 73 from a Mem or s
0470: 71 6c 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a 20 qlite3_value.**
0480: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63 6f structure..*/.co
0490: 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 nst void *sqlite
04a0: 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71 6c 3_value_blob(sql
04b0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c ite3_value *pVal
04c0: 29 7b 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d ){. Mem *p = (M
04d0: 65 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20 em*)pVal;. if(
04e0: 70 2d 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d 5f p->flags & (MEM_
04f0: 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29 7b Blob|MEM_Str) ){
0500: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a . return p->z
0510: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 ;. }else{. r
0520: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 eturn sqlite3_va
0530: 6c 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a lue_text(pVal);.
0540: 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 }.}.int sqlite
0550: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71 3_value_bytes(sq
0560: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
0570: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
0580: 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70 ite3ValueBytes(p
0590: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 Val, SQLITE_UTF8
05a0: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 );.}.int sqlite3
05b0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73 _value_bytes16(s
05c0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
05d0: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 al){. return sq
05e0: 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 lite3ValueBytes(
05f0: 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 pVal, SQLITE_UTF
0600: 31 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75 16NATIVE);.}.dou
0610: 62 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 ble sqlite3_valu
0620: 65 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 e_double(sqlite3
0630: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 _value *pVal){.
0640: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 return sqlite3V
0650: 64 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65 dbeRealValue((Me
0660: 6d 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20 m*)pVal);.}.int
0670: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e sqlite3_value_in
0680: 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t(sqlite3_value
0690: 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e *pVal){. return
06a0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74 56 sqlite3VdbeIntV
06b0: 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 61 6c 29 alue((Mem*)pVal)
06c0: 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 ;.}.sqlite_int64
06d0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 sqlite3_value_i
06e0: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 76 61 6c nt64(sqlite3_val
06f0: 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 ue *pVal){. ret
0700: 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65 49 urn sqlite3VdbeI
0710: 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70 56 ntValue((Mem*)pV
0720: 61 6c 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 al);.}.const uns
0730: 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 igned char *sqli
0740: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 73 te3_value_text(s
0750: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
0760: 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 28 63 al){. return (c
0770: 6f 6e 73 74 20 63 68 61 72 20 2a 29 73 71 6c 69 onst char *)sqli
0780: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 te3ValueText(pVa
0790: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b l, SQLITE_UTF8);
07a0: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 .}.#ifndef SQLIT
07b0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e E_OMIT_UTF16.con
07c0: 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 st void *sqlite3
07d0: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 73 71 _value_text16(sq
07e0: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20 70 56 61 lite3_value* pVa
07f0: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
0800: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
0810: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 al, SQLITE_UTF16
0820: 4e 41 54 49 56 45 29 3b 0a 7d 0a 63 6f 6e 73 74 NATIVE);.}.const
0830: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 void *sqlite3_v
0840: 61 6c 75 65 5f 74 65 78 74 31 36 62 65 28 73 71 alue_text16be(sq
0850: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
0860: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c l){. return sql
0870: 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
0880: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 al, SQLITE_UTF16
0890: 42 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 BE);.}.const voi
08a0: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 d *sqlite3_value
08b0: 5f 74 65 78 74 31 36 6c 65 28 73 71 6c 69 74 65 _text16le(sqlite
08c0: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 3_value *pVal){.
08d0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
08e0: 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 ValueText(pVal,
08f0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 3b SQLITE_UTF16LE);
0900: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
0910: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a ITE_OMIT_UTF16 *
0920: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 61 /.int sqlite3_va
0930: 6c 75 65 5f 74 79 70 65 28 73 71 6c 69 74 65 33 lue_type(sqlite3
0940: 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20 _value* pVal){.
0950: 20 72 65 74 75 72 6e 20 70 56 61 6c 2d 3e 74 79 return pVal->ty
0960: 70 65 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a pe;.}../********
0970: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0980: 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 72 65 73 **** sqlite3_res
0990: 75 6c 74 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ult_ **********
09a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
09b0: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c *****.** The fol
09c0: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 lowing routines
09d0: 61 72 65 20 75 73 65 64 20 62 79 20 75 73 65 72 are used by user
09e0: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f -defined functio
09f0: 6e 73 20 74 6f 20 73 70 65 63 69 66 79 0a 2a 2a ns to specify.**
0a00: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 the function re
0a10: 73 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 sult..*/.void sq
0a20: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62 6c 6f lite3_result_blo
0a30: 62 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e b(. sqlite3_con
0a40: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 text *pCtx, . c
0a50: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 onst void *z, .
0a60: 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 int n, . void
0a70: 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a (*xDel)(void *).
0a80: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 3d ){. assert( n>=
0a90: 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 0 );. sqlite3Vd
0aa0: 62 65 4d 65 6d 53 65 74 53 74 72 28 26 70 43 74 beMemSetStr(&pCt
0ab0: 78 2d 3e 73 2c 20 7a 2c 20 6e 2c 20 30 2c 20 78 x->s, z, n, 0, x
0ac0: 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c Del);.}.void sql
0ad0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 ite3_result_doub
0ae0: 6c 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 le(sqlite3_conte
0af0: 78 74 20 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65 xt *pCtx, double
0b00: 20 72 56 61 6c 29 7b 0a 20 20 73 71 6c 69 74 65 rVal){. sqlite
0b10: 33 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 3VdbeMemSetDoubl
0b20: 65 28 26 70 43 74 78 2d 3e 73 2c 20 72 56 61 6c e(&pCtx->s, rVal
0b30: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 );.}.void sqlite
0b40: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 28 73 3_result_error(s
0b50: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
0b60: 70 43 74 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 pCtx, const char
0b70: 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 70 *z, int n){. p
0b80: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 31 Ctx->isError = 1
0b90: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d ;. sqlite3VdbeM
0ba0: 65 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e emSetStr(&pCtx->
0bb0: 73 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f s, z, n, SQLITE_
0bc0: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 54 52 41 UTF8, SQLITE_TRA
0bd0: 4e 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20 NSIENT);.}.void
0be0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 sqlite3_result_e
0bf0: 72 72 6f 72 31 36 28 73 71 6c 69 74 65 33 5f 63 rror16(sqlite3_c
0c00: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f ontext *pCtx, co
0c10: 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 69 6e 74 nst void *z, int
0c20: 20 6e 29 7b 0a 20 20 70 43 74 78 2d 3e 69 73 45 n){. pCtx->isE
0c30: 72 72 6f 72 20 3d 20 31 3b 0a 20 20 73 71 6c 69 rror = 1;. sqli
0c40: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 te3VdbeMemSetStr
0c50: 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 6e 2c (&pCtx->s, z, n,
0c60: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
0c70: 49 56 45 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e IVE, SQLITE_TRAN
0c80: 53 49 45 4e 54 29 3b 0a 7d 0a 76 6f 69 64 20 73 SIENT);.}.void s
0c90: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e qlite3_result_in
0ca0: 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 t(sqlite3_contex
0cb0: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 56 61 t *pCtx, int iVa
0cc0: 6c 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 l){. sqlite3Vdb
0cd0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 26 70 43 eMemSetInt64(&pC
0ce0: 74 78 2d 3e 73 2c 20 28 69 36 34 29 69 56 61 6c tx->s, (i64)iVal
0cf0: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 );.}.void sqlite
0d00: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 73 3_result_int64(s
0d10: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
0d20: 70 43 74 78 2c 20 69 36 34 20 69 56 61 6c 29 7b pCtx, i64 iVal){
0d30: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 . sqlite3VdbeMe
0d40: 6d 53 65 74 49 6e 74 36 34 28 26 70 43 74 78 2d mSetInt64(&pCtx-
0d50: 3e 73 2c 20 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69 >s, iVal);.}.voi
0d60: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 d sqlite3_result
0d70: 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 63 6f _null(sqlite3_co
0d80: 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20 ntext *pCtx){.
0d90: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 sqlite3VdbeMemSe
0da0: 74 4e 75 6c 6c 28 26 70 43 74 78 2d 3e 73 29 3b tNull(&pCtx->s);
0db0: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f .}.void sqlite3_
0dc0: 72 65 73 75 6c 74 5f 74 65 78 74 28 0a 20 20 73 result_text(. s
0dd0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a qlite3_context *
0de0: 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20 63 pCtx, . const c
0df0: 68 61 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20 6e har *z, . int n
0e00: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 ,. void (*xDel)
0e10: 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 73 71 (void *).){. sq
0e20: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 lite3VdbeMemSetS
0e30: 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 7a 2c 20 tr(&pCtx->s, z,
0e40: 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 n, SQLITE_UTF8,
0e50: 78 44 65 6c 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 xDel);.}.#ifndef
0e60: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
0e70: 31 36 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 16.void sqlite3_
0e80: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 0a 20 result_text16(.
0e90: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 sqlite3_context
0ea0: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 *pCtx, . const
0eb0: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 void *z, . int
0ec0: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 n, . void (*xD
0ed0: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 el)(void *).){.
0ee0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 sqlite3VdbeMemS
0ef0: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 etStr(&pCtx->s,
0f00: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 z, n, SQLITE_UTF
0f10: 31 36 4e 41 54 49 56 45 2c 20 78 44 65 6c 29 3b 16NATIVE, xDel);
0f20: 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f .}.void sqlite3_
0f30: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 62 65 28 result_text16be(
0f40: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 . sqlite3_conte
0f50: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e xt *pCtx, . con
0f60: 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 st void *z, . i
0f70: 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a nt n, . void (*
0f80: 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b xDel)(void *).){
0f90: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 . sqlite3VdbeMe
0fa0: 6d 53 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 mSetStr(&pCtx->s
0fb0: 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 , z, n, SQLITE_U
0fc0: 54 46 31 36 42 45 2c 20 78 44 65 6c 29 3b 0a 7d TF16BE, xDel);.}
0fd0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 .void sqlite3_re
0fe0: 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 28 0a 20 sult_text16le(.
0ff0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 sqlite3_context
1000: 20 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 *pCtx, . const
1010: 20 76 6f 69 64 20 2a 7a 2c 20 0a 20 20 69 6e 74 void *z, . int
1020: 20 6e 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 n, . void (*xD
1030: 65 6c 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 el)(void *).){.
1040: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 sqlite3VdbeMemS
1050: 65 74 53 74 72 28 26 70 43 74 78 2d 3e 73 2c 20 etStr(&pCtx->s,
1060: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 z, n, SQLITE_UTF
1070: 31 36 4c 45 2c 20 78 44 65 6c 29 3b 0a 7d 0a 23 16LE, xDel);.}.#
1080: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
1090: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 76 6f OMIT_UTF16 */.vo
10a0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c id sqlite3_resul
10b0: 74 5f 76 61 6c 75 65 28 73 71 6c 69 74 65 33 5f t_value(sqlite3_
10c0: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 73 context *pCtx, s
10d0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
10e0: 61 6c 75 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 alue){. sqlite3
10f0: 56 64 62 65 4d 65 6d 43 6f 70 79 28 26 70 43 74 VdbeMemCopy(&pCt
1100: 78 2d 3e 73 2c 20 70 56 61 6c 75 65 29 3b 0a 7d x->s, pValue);.}
1110: 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65 .../*.** Execute
1120: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 the statement p
1130: 53 74 6d 74 2c 20 65 69 74 68 65 72 20 75 6e 74 Stmt, either unt
1140: 69 6c 20 61 20 72 6f 77 20 6f 66 20 64 61 74 61 il a row of data
1150: 20 69 73 20 72 65 61 64 79 2c 20 74 68 65 0a 2a is ready, the.*
1160: 2a 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 63 * statement is c
1170: 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65 63 75 74 ompletely execut
1180: 65 64 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f ed or an error o
1190: 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ccurs..*/.int sq
11a0: 6c 69 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74 lite3_step(sqlit
11b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b e3_stmt *pStmt){
11c0: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 . Vdbe *p = (Vd
11d0: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 73 71 6c be*)pStmt;. sql
11e0: 69 74 65 33 20 2a 64 62 3b 0a 20 20 69 6e 74 20 ite3 *db;. int
11f0: 72 63 3b 0a 0a 20 20 69 66 28 20 70 3d 3d 30 20 rc;.. if( p==0
1200: 7c 7c 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 || p->magic!=VDB
1210: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20 E_MAGIC_RUN ){.
1220: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
1230: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 _MISUSE;. }. i
1240: 66 28 20 70 2d 3e 61 62 6f 72 74 65 64 20 29 7b f( p->aborted ){
1250: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
1260: 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 20 20 TE_ABORT;. }.
1270: 69 66 28 20 70 2d 3e 70 63 3c 3d 30 20 26 26 20 if( p->pc<=0 &&
1280: 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20 p->expired ){.
1290: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c if( p->rc==SQL
12a0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
12b0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 53 p->rc = SQLITE_S
12c0: 43 48 45 4d 41 3b 0a 20 20 20 20 7d 0a 20 20 20 CHEMA;. }.
12d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 return SQLITE_E
12e0: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 64 62 20 3d RROR;. }. db =
12f0: 20 70 2d 3e 64 62 3b 0a 20 20 69 66 28 20 73 71 p->db;. if( sq
1300: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 lite3SafetyOn(db
1310: 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d ) ){. p->rc =
1320: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a SQLITE_MISUSE;.
1330: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1340: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 E_MISUSE;. }.
1350: 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 23 if( p->pc<0 ){.#
1360: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1370: 49 54 5f 54 52 41 43 45 0a 20 20 20 20 2f 2a 20 IT_TRACE. /*
1380: 49 6e 76 6f 6b 65 20 74 68 65 20 74 72 61 63 65 Invoke the trace
1390: 20 63 61 6c 6c 62 61 63 6b 20 69 66 20 74 68 65 callback if the
13a0: 72 65 20 69 73 20 6f 6e 65 0a 20 20 20 20 2a 2f re is one. */
13b0: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 78 54 72 . if( db->xTr
13c0: 61 63 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 74 ace && !db->init
13d0: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 61 .busy ){. a
13e0: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 ssert( p->nOp>0
13f0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
1400: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 p->aOp[p->nOp-1
1410: 5d 2e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f ].opcode==OP_Noo
1420: 70 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 p );. asser
1430: 74 28 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 t( p->aOp[p->nOp
1440: 2d 31 5d 2e 70 33 21 3d 30 20 29 3b 0a 20 20 20 -1].p3!=0 );.
1450: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f assert( p->aO
1460: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 74 79 p[p->nOp-1].p3ty
1470: 70 65 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29 pe==P3_DYNAMIC )
1480: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 ;. sqlite3S
1490: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 afetyOff(db);.
14a0: 20 20 20 20 64 62 2d 3e 78 54 72 61 63 65 28 64 db->xTrace(d
14b0: 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 70 2d b->pTraceArg, p-
14c0: 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 >aOp[p->nOp-1].p
14d0: 33 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71 3);. if( sq
14e0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 lite3SafetyOn(db
14f0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e ) ){. p->
1500: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 rc = SQLITE_MISU
1510: 53 45 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 SE;. retu
1520: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
1530: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
1540: 20 20 20 20 69 66 28 20 64 62 2d 3e 78 50 72 6f if( db->xPro
1550: 66 69 6c 65 20 26 26 20 21 64 62 2d 3e 69 6e 69 file && !db->ini
1560: 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 20 20 t.busy ){.
1570: 64 6f 75 62 6c 65 20 72 4e 6f 77 3b 0a 20 20 20 double rNow;.
1580: 20 20 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72 sqlite3OsCurr
1590: 65 6e 74 54 69 6d 65 28 26 72 4e 6f 77 29 3b 0a entTime(&rNow);.
15a0: 20 20 20 20 20 20 70 2d 3e 73 74 61 72 74 54 69 p->startTi
15b0: 6d 65 20 3d 20 28 72 4e 6f 77 20 2d 20 28 69 6e me = (rNow - (in
15c0: 74 29 72 4e 6f 77 29 2a 33 36 30 30 2e 30 2a 32 t)rNow)*3600.0*2
15d0: 34 2e 30 2a 31 30 30 30 30 30 30 30 30 30 2e 30 4.0*1000000000.0
15e0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a ;. }.#endif..
15f0: 20 20 20 20 2f 2a 20 50 72 69 6e 74 20 61 20 63 /* Print a c
1600: 6f 70 79 20 6f 66 20 53 51 4c 20 61 73 20 69 74 opy of SQL as it
1610: 20 69 73 20 65 78 65 63 75 74 65 64 20 69 66 20 is executed if
1620: 74 68 65 20 53 51 4c 5f 54 52 41 43 45 20 70 72 the SQL_TRACE pr
1630: 61 67 6d 61 20 69 73 20 74 75 72 6e 65 64 0a 20 agma is turned.
1640: 20 20 20 2a 2a 20 6f 6e 20 69 6e 20 64 65 62 75 ** on in debu
1650: 67 67 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 20 20 gging mode..
1660: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
1670: 5f 44 45 42 55 47 0a 20 20 20 20 69 66 28 20 28 _DEBUG. if( (
1680: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 db->flags & SQLI
1690: 54 45 5f 53 71 6c 54 72 61 63 65 29 21 3d 30 20 TE_SqlTrace)!=0
16a0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
16b0: 44 65 62 75 67 50 72 69 6e 74 66 28 22 53 51 4c DebugPrintf("SQL
16c0: 2d 74 72 61 63 65 3a 20 25 73 5c 6e 22 2c 20 70 -trace: %s\n", p
16d0: 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e ->aOp[p->nOp-1].
16e0: 70 33 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 p3);. }.#endi
16f0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 f /* SQLITE_DEBU
1700: 47 20 2a 2f 0a 0a 20 20 20 20 64 62 2d 3e 61 63 G */.. db->ac
1710: 74 69 76 65 56 64 62 65 43 6e 74 2b 2b 3b 0a 20 tiveVdbeCnt++;.
1720: 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b 0a 20 20 p->pc = 0;.
1730: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 }.#ifndef SQLITE
1740: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 _OMIT_EXPLAIN.
1750: 69 66 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 if( p->explain )
1760: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
1770: 65 33 56 64 62 65 4c 69 73 74 28 70 29 3b 0a 20 e3VdbeList(p);.
1780: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 20 2f 2a }else.#endif /*
1790: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 SQLITE_OMIT_EXP
17a0: 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a 20 20 20 20 LAIN */. {.
17b0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 rc = sqlite3Vdbe
17c0: 45 78 65 63 28 70 29 3b 0a 20 20 7d 0a 0a 20 20 Exec(p);. }..
17d0: 69 66 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 if( sqlite3Safet
17e0: 79 4f 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 yOff(db) ){.
17f0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 rc = SQLITE_MISU
1800: 53 45 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 SE;. }..#ifndef
1810: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 SQLITE_OMIT_TRA
1820: 43 45 0a 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 CE. /* Invoke t
1830: 68 65 20 70 72 6f 66 69 6c 65 20 63 61 6c 6c 62 he profile callb
1840: 61 63 6b 20 69 66 20 74 68 65 72 65 20 69 73 20 ack if there is
1850: 6f 6e 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 one. */. if( r
1860: 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57 20 26 26 c!=SQLITE_ROW &&
1870: 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 26 26 db->xProfile &&
1880: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 !db->init.busy
1890: 29 7b 0a 20 20 20 20 64 6f 75 62 6c 65 20 72 4e ){. double rN
18a0: 6f 77 3b 0a 20 20 20 20 75 36 34 20 65 6c 61 70 ow;. u64 elap
18b0: 73 65 54 69 6d 65 3b 0a 0a 20 20 20 20 73 71 6c seTime;.. sql
18c0: 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d ite3OsCurrentTim
18d0: 65 28 26 72 4e 6f 77 29 3b 0a 20 20 20 20 65 6c e(&rNow);. el
18e0: 61 70 73 65 54 69 6d 65 20 3d 20 28 72 4e 6f 77 apseTime = (rNow
18f0: 20 2d 20 28 69 6e 74 29 72 4e 6f 77 29 2a 33 36 - (int)rNow)*36
1900: 30 30 2e 30 2a 32 34 2e 30 2a 31 30 30 30 30 30 00.0*24.0*100000
1910: 30 30 30 30 2e 30 20 2d 20 70 2d 3e 73 74 61 72 0000.0 - p->star
1920: 74 54 69 6d 65 3b 0a 20 20 20 20 61 73 73 65 72 tTime;. asser
1930: 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 20 t( p->nOp>0 );.
1940: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f assert( p->aO
1950: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 6f 70 63 6f p[p->nOp-1].opco
1960: 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 3b 0a 20 de==OP_Noop );.
1970: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f assert( p->aO
1980: 70 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 21 3d p[p->nOp-1].p3!=
1990: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
19a0: 20 70 2d 3e 61 4f 70 5b 70 2d 3e 6e 4f 70 2d 31 p->aOp[p->nOp-1
19b0: 5d 2e 70 33 74 79 70 65 3d 3d 50 33 5f 44 59 4e ].p3type==P3_DYN
19c0: 41 4d 49 43 20 29 3b 0a 20 20 20 20 64 62 2d 3e AMIC );. db->
19d0: 78 50 72 6f 66 69 6c 65 28 64 62 2d 3e 70 50 72 xProfile(db->pPr
19e0: 6f 66 69 6c 65 41 72 67 2c 20 70 2d 3e 61 4f 70 ofileArg, p->aOp
19f0: 5b 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 2c 20 65 [p->nOp-1].p3, e
1a00: 6c 61 70 73 65 54 69 6d 65 29 3b 0a 20 20 7d 0a lapseTime);. }.
1a10: 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 #endif.. sqlite
1a20: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72 63 3Error(p->db, rc
1a30: 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3f 20 22 , p->zErrMsg ? "
1a40: 25 73 22 20 3a 20 30 2c 20 70 2d 3e 7a 45 72 72 %s" : 0, p->zErr
1a50: 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 Msg);. return r
1a60: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 c;.}../*.** Extr
1a70: 61 63 74 20 74 68 65 20 75 73 65 72 20 64 61 74 act the user dat
1a80: 61 20 66 72 6f 6d 20 61 20 73 71 6c 69 74 65 33 a from a sqlite3
1a90: 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 _context structu
1aa0: 72 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 0a re and return a.
1ab0: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 ** pointer to it
1ac0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
1ad0: 65 33 5f 75 73 65 72 5f 64 61 74 61 28 73 71 6c e3_user_data(sql
1ae0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 ite3_context *p)
1af0: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 {. assert( p &&
1b00: 20 70 2d 3e 70 46 75 6e 63 20 29 3b 0a 20 20 72 p->pFunc );. r
1b10: 65 74 75 72 6e 20 70 2d 3e 70 46 75 6e 63 2d 3e eturn p->pFunc->
1b20: 70 55 73 65 72 44 61 74 61 3b 0a 7d 0a 0a 2f 2a pUserData;.}../*
1b30: 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20 .** Allocate or
1b40: 72 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65 return the aggre
1b50: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 gate context for
1b60: 20 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e a user function
1b70: 2e 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 . A new.** cont
1b80: 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 ext is allocated
1b90: 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61 on the first ca
1ba0: 6c 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20 ll. Subsequent
1bb0: 63 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65 calls return the
1bc0: 0a 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74 .** same context
1bd0: 20 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e that was return
1be0: 65 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c ed on prior call
1bf0: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 s..*/.void *sqli
1c00: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f te3_aggregate_co
1c10: 6e 74 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f ntext(sqlite3_co
1c20: 6e 74 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42 ntext *p, int nB
1c30: 79 74 65 29 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 yte){. Mem *pMe
1c40: 6d 20 3d 20 70 2d 3e 70 4d 65 6d 3b 0a 20 20 61 m = p->pMem;. a
1c50: 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70 ssert( p && p->p
1c60: 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e 63 Func && p->pFunc
1c70: 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 69 66 28 ->xStep );. if(
1c80: 20 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 (pMem->flags &
1c90: 4d 45 4d 5f 41 67 67 29 3d 3d 30 20 29 7b 0a 20 MEM_Agg)==0 ){.
1ca0: 20 20 20 69 66 28 20 6e 42 79 74 65 3d 3d 30 20 if( nByte==0
1cb0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
1cc0: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 3d 3d 4d 45 pMem->flags==ME
1cd0: 4d 5f 4e 75 6c 6c 20 29 3b 0a 20 20 20 20 20 20 M_Null );.
1ce0: 70 4d 65 6d 2d 3e 7a 20 3d 20 30 3b 0a 20 20 20 pMem->z = 0;.
1cf0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 4d }else{. pM
1d00: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f em->flags = MEM_
1d10: 41 67 67 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d Agg;. pMem-
1d20: 3e 78 44 65 6c 20 3d 20 73 71 6c 69 74 65 33 46 >xDel = sqlite3F
1d30: 72 65 65 58 3b 0a 20 20 20 20 20 20 2a 28 46 75 reeX;. *(Fu
1d40: 6e 63 44 65 66 2a 2a 29 26 70 4d 65 6d 2d 3e 69 ncDef**)&pMem->i
1d50: 20 3d 20 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20 = p->pFunc;.
1d60: 20 20 20 69 66 28 20 6e 42 79 74 65 3c 3d 4e 42 if( nByte<=NB
1d70: 46 53 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4d FS ){. pM
1d80: 65 6d 2d 3e 7a 20 3d 20 70 4d 65 6d 2d 3e 7a 53 em->z = pMem->zS
1d90: 68 6f 72 74 3b 0a 20 20 20 20 20 20 20 20 6d 65 hort;. me
1da0: 6d 73 65 74 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c mset(pMem->z, 0,
1db0: 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 7d nByte);. }
1dc0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d else{. pM
1dd0: 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69 74 65 4d 61 em->z = sqliteMa
1de0: 6c 6c 6f 63 28 20 6e 42 79 74 65 20 29 3b 0a 20 lloc( nByte );.
1df0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
1e00: 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a . return (void*
1e10: 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a )pMem->z;.}../*.
1e20: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 75 ** Return the au
1e30: 78 69 6c 61 72 79 20 64 61 74 61 20 70 6f 69 6e xilary data poin
1e40: 74 65 72 2c 20 69 66 20 61 6e 79 2c 20 66 6f 72 ter, if any, for
1e50: 20 74 68 65 20 69 41 72 67 27 74 68 20 61 72 67 the iArg'th arg
1e60: 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 ument to.** the
1e70: 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 user-function de
1e80: 66 69 6e 65 64 20 62 79 20 70 43 74 78 2e 0a 2a fined by pCtx..*
1e90: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
1ea0: 67 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69 get_auxdata(sqli
1eb0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 te3_context *pCt
1ec0: 78 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20 x, int iArg){.
1ed0: 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 VdbeFunc *pVdbeF
1ee0: 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 62 unc = pCtx->pVdb
1ef0: 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 56 eFunc;. if( !pV
1f00: 64 62 65 46 75 6e 63 20 7c 7c 20 69 41 72 67 3e dbeFunc || iArg>
1f10: 3d 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 =pVdbeFunc->nAux
1f20: 20 7c 7c 20 69 41 72 67 3c 30 20 29 7b 0a 20 20 || iArg<0 ){.
1f30: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a return 0;. }.
1f40: 20 20 72 65 74 75 72 6e 20 70 56 64 62 65 46 75 return pVdbeFu
1f50: 6e 63 2d 3e 61 70 41 75 78 5b 69 41 72 67 5d 2e nc->apAux[iArg].
1f60: 70 41 75 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 pAux;.}../*.** S
1f70: 65 74 20 74 68 65 20 61 75 78 69 6c 61 72 79 20 et the auxilary
1f80: 64 61 74 61 20 70 6f 69 6e 74 65 72 20 61 6e 64 data pointer and
1f90: 20 64 65 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e delete function
1fa0: 2c 20 66 6f 72 20 74 68 65 20 69 41 72 67 27 74 , for the iArg't
1fb0: 68 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f h.** argument to
1fc0: 20 74 68 65 20 75 73 65 72 2d 66 75 6e 63 74 69 the user-functi
1fd0: 6f 6e 20 64 65 66 69 6e 65 64 20 62 79 20 70 43 on defined by pC
1fe0: 74 78 2e 20 41 6e 79 20 70 72 65 76 69 6f 75 73 tx. Any previous
1ff0: 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 64 65 6c value is.** del
2000: 65 74 65 64 20 62 79 20 63 61 6c 6c 69 6e 67 20 eted by calling
2010: 74 68 65 20 64 65 6c 65 74 65 20 66 75 6e 63 74 the delete funct
2020: 69 6f 6e 20 73 70 65 63 69 66 69 65 64 20 77 68 ion specified wh
2030: 65 6e 20 69 74 20 77 61 73 20 73 65 74 2e 0a 2a en it was set..*
2040: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 /.void sqlite3_s
2050: 65 74 5f 61 75 78 64 61 74 61 28 0a 20 20 73 71 et_auxdata(. sq
2060: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 lite3_context *p
2070: 43 74 78 2c 20 0a 20 20 69 6e 74 20 69 41 72 67 Ctx, . int iArg
2080: 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c , . void *pAux,
2090: 20 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 . void (*xDele
20a0: 74 65 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 te)(void*).){.
20b0: 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20 2a struct AuxData *
20c0: 70 41 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65 pAuxData;. Vdbe
20d0: 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 3b Func *pVdbeFunc;
20e0: 0a 20 20 69 66 28 20 69 41 72 67 3c 30 20 29 20 . if( iArg<0 )
20f0: 72 65 74 75 72 6e 3b 0a 0a 20 20 70 56 64 62 65 return;.. pVdbe
2100: 46 75 6e 63 20 3d 20 70 43 74 78 2d 3e 70 56 64 Func = pCtx->pVd
2110: 62 65 46 75 6e 63 3b 0a 20 20 69 66 28 20 21 70 beFunc;. if( !p
2120: 56 64 62 65 46 75 6e 63 20 7c 7c 20 70 56 64 62 VdbeFunc || pVdb
2130: 65 46 75 6e 63 2d 3e 6e 41 75 78 3c 3d 69 41 72 eFunc->nAux<=iAr
2140: 67 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 4d 61 g ){. int nMa
2150: 6c 6c 6f 63 20 3d 20 73 69 7a 65 6f 66 28 56 64 lloc = sizeof(Vd
2160: 62 65 46 75 6e 63 29 20 2b 20 73 69 7a 65 6f 66 beFunc) + sizeof
2170: 28 73 74 72 75 63 74 20 41 75 78 44 61 74 61 29 (struct AuxData)
2180: 2a 69 41 72 67 3b 0a 20 20 20 20 70 56 64 62 65 *iArg;. pVdbe
2190: 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 52 65 61 Func = sqliteRea
21a0: 6c 6c 6f 63 28 70 56 64 62 65 46 75 6e 63 2c 20 lloc(pVdbeFunc,
21b0: 6e 4d 61 6c 6c 6f 63 29 3b 0a 20 20 20 20 69 66 nMalloc);. if
21c0: 28 20 21 70 56 64 62 65 46 75 6e 63 20 29 20 72 ( !pVdbeFunc ) r
21d0: 65 74 75 72 6e 3b 0a 20 20 20 20 70 43 74 78 2d eturn;. pCtx-
21e0: 3e 70 56 64 62 65 46 75 6e 63 20 3d 20 70 56 64 >pVdbeFunc = pVd
21f0: 62 65 46 75 6e 63 3b 0a 20 20 20 20 6d 65 6d 73 beFunc;. mems
2200: 65 74 28 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 et(&pVdbeFunc->a
2210: 70 41 75 78 5b 70 56 64 62 65 46 75 6e 63 2d 3e pAux[pVdbeFunc->
2220: 6e 41 75 78 5d 2c 20 30 2c 20 0a 20 20 20 20 20 nAux], 0, .
2230: 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28 73 sizeof(s
2240: 74 72 75 63 74 20 41 75 78 44 61 74 61 29 2a 28 truct AuxData)*(
2250: 69 41 72 67 2b 31 2d 70 56 64 62 65 46 75 6e 63 iArg+1-pVdbeFunc
2260: 2d 3e 6e 41 75 78 29 29 3b 0a 20 20 20 20 70 56 ->nAux));. pV
2270: 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 20 3d 20 dbeFunc->nAux =
2280: 69 41 72 67 2b 31 3b 0a 20 20 20 20 70 56 64 62 iArg+1;. pVdb
2290: 65 46 75 6e 63 2d 3e 70 46 75 6e 63 20 3d 20 70 eFunc->pFunc = p
22a0: 43 74 78 2d 3e 70 46 75 6e 63 3b 0a 20 20 7d 0a Ctx->pFunc;. }.
22b0: 0a 20 20 70 41 75 78 44 61 74 61 20 3d 20 26 70 . pAuxData = &p
22c0: 56 64 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b VdbeFunc->apAux[
22d0: 69 41 72 67 5d 3b 0a 20 20 69 66 28 20 70 41 75 iArg];. if( pAu
22e0: 78 44 61 74 61 2d 3e 70 41 75 78 20 26 26 20 70 xData->pAux && p
22f0: 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 AuxData->xDelete
2300: 20 29 7b 0a 20 20 20 20 70 41 75 78 44 61 74 61 ){. pAuxData
2310: 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 44 61 ->xDelete(pAuxDa
2320: 74 61 2d 3e 70 41 75 78 29 3b 0a 20 20 7d 0a 20 ta->pAux);. }.
2330: 20 70 41 75 78 44 61 74 61 2d 3e 70 41 75 78 20 pAuxData->pAux
2340: 3d 20 70 41 75 78 3b 0a 20 20 70 41 75 78 44 61 = pAux;. pAuxDa
2350: 74 61 2d 3e 78 44 65 6c 65 74 65 20 3d 20 78 44 ta->xDelete = xD
2360: 65 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 elete;.}../*.**
2370: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
2380: 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65 20 53 r of times the S
2390: 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 tep function of
23a0: 61 20 61 67 67 72 65 67 61 74 65 20 68 61 73 20 a aggregate has
23b0: 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c 65 64 2e been .** called.
23c0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
23d0: 69 6e 65 20 69 73 20 64 65 66 69 6e 65 64 20 68 ine is defined h
23e0: 65 72 65 20 69 6e 20 76 64 62 65 2e 63 20 62 65 ere in vdbe.c be
23f0: 63 61 75 73 65 20 69 74 20 64 65 70 65 6e 64 73 cause it depends
2400: 20 6f 6e 20 6b 6e 6f 77 69 6e 67 0a 2a 2a 20 74 on knowing.** t
2410: 68 65 20 69 6e 74 65 72 6e 61 6c 73 20 6f 66 20 he internals of
2420: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 the sqlite3_cont
2430: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 77 68 ext structure wh
2440: 69 63 68 20 69 73 20 6f 6e 6c 79 20 64 65 66 69 ich is only defi
2450: 6e 65 64 20 69 6e 0a 2a 2a 20 74 68 69 73 20 73 ned in.** this s
2460: 6f 75 72 63 65 20 66 69 6c 65 2e 0a 2a 2f 0a 69 ource file..*/.i
2470: 6e 74 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 nt sqlite3_aggre
2480: 67 61 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 gate_count(sqlit
2490: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a e3_context *p){.
24a0: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70 assert( p && p
24b0: 2d 3e 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 ->pFunc && p->pF
24c0: 75 6e 63 2d 3e 78 53 74 65 70 20 29 3b 0a 20 20 unc->xStep );.
24d0: 72 65 74 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d 3e return p->pMem->
24e0: 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 n;.}../*.** Retu
24f0: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
2500: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the
2510: 72 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74 result set for t
2520: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 he statement pSt
2530: 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 mt..*/.int sqlit
2540: 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 e3_column_count(
2550: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
2560: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 tmt){. Vdbe *pV
2570: 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d m = (Vdbe *)pStm
2580: 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20 t;. return pVm
2590: 3f 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d ? pVm->nResColum
25a0: 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n : 0;.}../*.**
25b0: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
25c0: 72 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 r of values avai
25d0: 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 lable from the c
25e0: 75 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 urrent row of th
25f0: 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 e.** currently e
2600: 78 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 xecuting stateme
2610: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 nt pStmt..*/.int
2620: 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f sqlite3_data_co
2630: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 unt(sqlite3_stmt
2640: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 *pStmt){. Vdbe
2650: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 *pVm = (Vdbe *)
2660: 70 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d pStmt;. if( pVm
2670: 3d 3d 30 20 7c 7c 20 21 70 56 6d 2d 3e 72 65 73 ==0 || !pVm->res
2680: 4f 6e 53 74 61 63 6b 20 29 20 72 65 74 75 72 6e OnStack ) return
2690: 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 0;. return pVm
26a0: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d 0a ->nResColumn;.}.
26b0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f ../*.** Check to
26c0: 20 73 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 see if column i
26d0: 43 6f 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e Col of the given
26e0: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61 statement is va
26f0: 6c 69 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69 lid. If.** it i
2700: 73 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e s, return a poin
2710: 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66 ter to the Mem f
2720: 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 or the value of
2730: 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 that column..**
2740: 49 66 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76 If iCol is not v
2750: 61 6c 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70 alid, return a p
2760: 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20 ointer to a Mem
2770: 77 68 69 63 68 20 68 61 73 20 61 20 76 61 6c 75 which has a valu
2780: 65 0a 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f e.** of NULL..*/
2790: 0a 73 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c .static Mem *col
27a0: 75 6d 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73 umnMem(sqlite3_s
27b0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
27c0: 69 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 20 i){. Vdbe *pVm
27d0: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b = (Vdbe *)pStmt;
27e0: 0a 20 20 69 6e 74 20 76 61 6c 73 20 3d 20 73 71 . int vals = sq
27f0: 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74 lite3_data_count
2800: 28 70 53 74 6d 74 29 3b 0a 20 20 69 66 28 20 69 (pStmt);. if( i
2810: 3e 3d 76 61 6c 73 20 7c 7c 20 69 3c 30 20 29 7b >=vals || i<0 ){
2820: 0a 20 20 20 20 73 74 61 74 69 63 20 4d 65 6d 20 . static Mem
2830: 6e 75 6c 6c 4d 65 6d 3b 0a 20 20 20 20 69 66 28 nullMem;. if(
2840: 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 67 73 3d 3d nullMem.flags==
2850: 30 20 29 7b 20 6e 75 6c 6c 4d 65 6d 2e 66 6c 61 0 ){ nullMem.fla
2860: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 20 7d gs = MEM_Null; }
2870: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f . sqlite3Erro
2880: 72 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54 r(pVm->db, SQLIT
2890: 45 5f 52 41 4e 47 45 2c 20 30 29 3b 0a 20 20 20 E_RANGE, 0);.
28a0: 20 72 65 74 75 72 6e 20 26 6e 75 6c 6c 4d 65 6d return &nullMem
28b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 26 ;. }. return &
28c0: 70 56 6d 2d 3e 70 54 6f 73 5b 28 31 2d 76 61 6c pVm->pTos[(1-val
28d0: 73 29 2b 69 5d 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a s)+i];.}../*****
28e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28f0: 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f ******* sqlite3_
2900: 63 6f 6c 75 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a column_ *******
2910: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2920: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 ********.** The
2930: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e following routin
2940: 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 61 es are used to a
2950: 63 63 65 73 73 20 65 6c 65 6d 65 6e 74 73 20 6f ccess elements o
2960: 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f f the current ro
2970: 77 0a 2a 2a 20 69 6e 20 74 68 65 20 72 65 73 75 w.** in the resu
2980: 6c 74 20 73 65 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 lt set..*/.const
2990: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 void *sqlite3_c
29a0: 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 73 71 6c 69 74 olumn_blob(sqlit
29b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
29c0: 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 6e int i){. return
29d0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 sqlite3_value_b
29e0: 6c 6f 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 lob( columnMem(p
29f0: 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 Stmt,i) );.}.int
2a00: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
2a10: 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f 73 74 bytes(sqlite3_st
2a20: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 mt *pStmt, int i
2a30: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
2a40: 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 te3_value_bytes(
2a50: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 columnMem(pStmt
2a60: 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c ,i) );.}.int sql
2a70: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 ite3_column_byte
2a80: 73 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 s16(sqlite3_stmt
2a90: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b *pStmt, int i){
2aa0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
2ab0: 33 5f 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 3_value_bytes16(
2ac0: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 columnMem(pStmt
2ad0: 2c 69 29 20 29 3b 0a 7d 0a 64 6f 75 62 6c 65 20 ,i) );.}.double
2ae0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 sqlite3_column_d
2af0: 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 ouble(sqlite3_st
2b00: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 mt *pStmt, int i
2b10: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
2b20: 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 te3_value_double
2b30: 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d ( columnMem(pStm
2b40: 74 2c 69 29 20 29 3b 0a 7d 0a 69 6e 74 20 73 71 t,i) );.}.int sq
2b50: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 lite3_column_int
2b60: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 (sqlite3_stmt *p
2b70: 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 Stmt, int i){.
2b80: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 return sqlite3_v
2b90: 61 6c 75 65 5f 69 6e 74 28 20 63 6f 6c 75 6d 6e alue_int( column
2ba0: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a Mem(pStmt,i) );.
2bb0: 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 }.sqlite_int64 s
2bc0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e qlite3_column_in
2bd0: 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 t64(sqlite3_stmt
2be0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b *pStmt, int i){
2bf0: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
2c00: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28 20 63 3_value_int64( c
2c10: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 olumnMem(pStmt,i
2c20: 29 20 29 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 ) );.}.const uns
2c30: 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 igned char *sqli
2c40: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 te3_column_text(
2c50: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 sqlite3_stmt *pS
2c60: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 72 tmt, int i){. r
2c70: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 eturn sqlite3_va
2c80: 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e lue_text( column
2c90: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a Mem(pStmt,i) );.
2ca0: 7d 0a 23 69 66 20 30 0a 73 71 6c 69 74 65 33 5f }.#if 0.sqlite3_
2cb0: 76 61 6c 75 65 20 2a 73 71 6c 69 74 65 33 5f 63 value *sqlite3_c
2cc0: 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 73 71 6c 69 olumn_value(sqli
2cd0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
2ce0: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 int i){. retur
2cf0: 6e 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d n columnMem(pStm
2d00: 74 2c 20 69 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a t, i);.}.#endif.
2d10: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
2d20: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 MIT_UTF16.const
2d30: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f void *sqlite3_co
2d40: 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c 69 lumn_text16(sqli
2d50: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
2d60: 20 69 6e 74 20 69 29 7b 0a 20 20 72 65 74 75 72 int i){. retur
2d70: 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f n sqlite3_value_
2d80: 74 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 text16( columnMe
2d90: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 7d 0a m(pStmt,i) );.}.
2da0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
2db0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 _OMIT_UTF16 */.i
2dc0: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d nt sqlite3_colum
2dd0: 6e 5f 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73 n_type(sqlite3_s
2de0: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
2df0: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c i){. return sql
2e00: 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 ite3_value_type(
2e10: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 columnMem(pStmt
2e20: 2c 69 29 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 ,i) );.}../*.**
2e30: 43 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d 74 68 Convert the N-th
2e40: 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 74 6d element of pStm
2e50: 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 69 6e t->pColName[] in
2e60: 74 6f 20 61 20 73 74 72 69 6e 67 20 75 73 69 6e to a string usin
2e70: 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 68 65 g.** xFunc() the
2e80: 6e 20 72 65 74 75 72 6e 20 74 68 61 74 20 73 74 n return that st
2e90: 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20 6f ring. If N is o
2ea0: 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 65 74 ut of range, ret
2eb0: 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 urn 0..**.** The
2ec0: 72 65 20 61 72 65 20 75 70 20 74 6f 20 35 20 6e re are up to 5 n
2ed0: 61 6d 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f ames for each co
2ee0: 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 20 64 lumn. useType d
2ef0: 65 74 65 72 6d 69 6e 65 73 20 77 68 69 63 68 0a etermines which.
2f00: 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 75 72 ** name is retur
2f10: 6e 65 64 2e 20 20 48 65 72 65 20 61 72 65 20 74 ned. Here are t
2f20: 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 he names:.**.**
2f30: 20 20 20 30 20 20 20 20 20 20 54 68 65 20 63 6f 0 The co
2f40: 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 74 20 lumn name as it
2f50: 73 68 6f 75 6c 64 20 62 65 20 64 69 73 70 6c 61 should be displa
2f60: 79 65 64 20 66 6f 72 20 6f 75 74 70 75 74 0a 2a yed for output.*
2f70: 2a 20 20 20 20 31 20 20 20 20 20 20 54 68 65 20 * 1 The
2f80: 64 61 74 61 74 79 70 65 20 6e 61 6d 65 20 66 6f datatype name fo
2f90: 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 r the column.**
2fa0: 20 20 20 32 20 20 20 20 20 20 54 68 65 20 6e 61 2 The na
2fb0: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 me of the databa
2fc0: 73 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 se that the colu
2fd0: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a mn derives from.
2fe0: 2a 2a 20 20 20 20 33 20 20 20 20 20 20 54 68 65 ** 3 The
2ff0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
3000: 6c 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 le that the colu
3010: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a mn derives from.
3020: 2a 2a 20 20 20 20 34 20 20 20 20 20 20 54 68 65 ** 4 The
3030: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
3040: 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74 le column that t
3050: 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e he result column
3060: 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a derives from.**
3070: 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 73 75 6c .** If the resul
3080: 74 20 69 73 20 6e 6f 74 20 61 20 73 69 6d 70 6c t is not a simpl
3090: 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 6e e column referen
30a0: 63 65 20 28 69 66 20 69 74 20 69 73 20 61 6e 20 ce (if it is an
30b0: 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 6f 72 expression.** or
30c0: 20 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 68 65 a constant) the
30d0: 6e 20 75 73 65 54 79 70 65 73 20 32 2c 20 33 2c n useTypes 2, 3,
30e0: 20 61 6e 64 20 34 20 72 65 74 75 72 6e 20 4e 55 and 4 return NU
30f0: 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f LL..*/.static co
3100: 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 6d 6e nst void *column
3110: 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f Name(. sqlite3_
3120: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 20 69 stmt *pStmt,. i
3130: 6e 74 20 4e 2c 0a 20 20 63 6f 6e 73 74 20 76 6f nt N,. const vo
3140: 69 64 20 2a 28 2a 78 46 75 6e 63 29 28 4d 65 6d id *(*xFunc)(Mem
3150: 2a 29 2c 0a 20 20 69 6e 74 20 75 73 65 54 79 70 *),. int useTyp
3160: 65 0a 29 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d e.){. Vdbe *p =
3170: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a (Vdbe *)pStmt;.
3180: 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74 65 int n = sqlite
3190: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70 3_column_count(p
31a0: 53 74 6d 74 29 3b 0a 0a 20 20 69 66 28 20 70 3d Stmt);.. if( p=
31b0: 3d 30 20 7c 7c 20 4e 3e 3d 6e 20 7c 7c 20 4e 3c =0 || N>=n || N<
31c0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
31d0: 30 3b 0a 20 20 7d 0a 20 20 4e 20 2b 3d 20 75 73 0;. }. N += us
31e0: 65 54 79 70 65 2a 6e 3b 0a 20 20 72 65 74 75 72 eType*n;. retur
31f0: 6e 20 78 46 75 6e 63 28 26 70 2d 3e 61 43 6f 6c n xFunc(&p->aCol
3200: 4e 61 6d 65 5b 4e 5d 29 3b 0a 7d 0a 0a 0a 2f 2a Name[N]);.}.../*
3210: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
3220: 61 6d 65 20 6f 66 20 74 68 65 20 4e 74 68 20 63 ame of the Nth c
3230: 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 olumn of the res
3240: 75 6c 74 20 73 65 74 20 72 65 74 75 72 6e 65 64 ult set returned
3250: 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65 by SQL.** state
3260: 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63 ment pStmt..*/.c
3270: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
3280: 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73 e3_column_name(s
3290: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
32a0: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 mt, int N){. re
32b0: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 turn columnName(
32c0: 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 pStmt, N, (const
32d0: 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 void*(*)(Mem*))
32e0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 sqlite3_value_te
32f0: 78 74 2c 20 30 29 3b 0a 7d 0a 23 69 66 6e 64 65 xt, 0);.}.#ifnde
3300: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 f SQLITE_OMIT_UT
3310: 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a F16.const void *
3320: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e sqlite3_column_n
3330: 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73 74 ame16(sqlite3_st
3340: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e mt *pStmt, int N
3350: 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 ){. return colu
3360: 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c mnName(pStmt, N,
3370: 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 (const void*(*)
3380: 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 (Mem*))sqlite3_v
3390: 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 30 29 3b alue_text16, 0);
33a0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
33b0: 20 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c 75 Return the colu
33c0: 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 74 mn declaration t
33d0: 79 70 65 20 28 69 66 20 61 70 70 6c 69 63 61 62 ype (if applicab
33e0: 6c 65 29 20 6f 66 20 74 68 65 20 27 69 27 74 68 le) of the 'i'th
33f0: 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68 column.** of th
3400: 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20 e result set of
3410: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53 SQL statement pS
3420: 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 tmt..*/.const ch
3430: 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 ar *sqlite3_colu
3440: 6d 6e 5f 64 65 63 6c 74 79 70 65 28 73 71 6c 69 mn_decltype(sqli
3450: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
3460: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 int N){. retur
3470: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 n columnName(pSt
3480: 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f mt, N, (const vo
3490: 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c id*(*)(Mem*))sql
34a0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c ite3_value_text,
34b0: 20 31 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 1);.}.#ifndef S
34c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
34d0: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c .const void *sql
34e0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c ite3_column_decl
34f0: 74 79 70 65 31 36 28 73 71 6c 69 74 65 33 5f 73 type16(sqlite3_s
3500: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 tmt *pStmt, int
3510: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c N){. return col
3520: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e umnName(pStmt, N
3530: 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a , (const void*(*
3540: 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f )(Mem*))sqlite3_
3550: 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 20 31 29 value_text16, 1)
3560: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
3570: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 LITE_OMIT_UTF16
3580: 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 */..#if !defined
3590: 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52 49 (SQLITE_OMIT_ORI
35a0: 47 49 4e 5f 4e 41 4d 45 53 29 20 26 26 20 30 0a GIN_NAMES) && 0.
35b0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
35c0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 name of the dat
35d0: 61 62 61 73 65 20 66 72 6f 6d 20 77 68 69 63 68 abase from which
35e0: 20 61 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e a result column
35f0: 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c derives..** NUL
3600: 4c 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 L is returned if
3610: 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 the result colu
3620: 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 73 mn is an express
3630: 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61 6e 74 20 ion or constant
3640: 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65 or.** anything e
3650: 6c 73 65 20 77 68 69 63 68 20 69 73 20 6e 6f 74 lse which is not
3660: 20 61 6e 20 75 6e 61 62 69 67 75 6f 75 73 20 72 an unabiguous r
3670: 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 64 61 eference to a da
3680: 74 61 62 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a tabase column..*
3690: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 /.const char *sq
36a0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 lite3_column_dat
36b0: 61 62 61 73 65 5f 6e 61 6d 65 28 73 71 6c 69 74 abase_name(sqlit
36c0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
36d0: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e int N){. return
36e0: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d columnName(pStm
36f0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 t, N, (const voi
3700: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 d*(*)(Mem*))sqli
3710: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 20 te3_value_text,
3720: 32 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 2);.}.#ifndef SQ
3730: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
3740: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 const void *sqli
3750: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 te3_column_datab
3760: 61 73 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 ase_name16(sqlit
3770: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 e3_stmt *pStmt,
3780: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e int N){. return
3790: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d columnName(pStm
37a0: 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 t, N, (const voi
37b0: 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 d*(*)(Mem*))sqli
37c0: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 te3_value_text16
37d0: 2c 20 32 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f , 2);.}.#endif /
37e0: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
37f0: 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 F16 */../*.** Re
3800: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 turn the name of
3810: 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d 20 the table from
3820: 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 which a result c
3830: 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a olumn derives..*
3840: 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e * NULL is return
3850: 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 ed if the result
3860: 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 column is an ex
3870: 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 pression or cons
3880: 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 tant or.** anyth
3890: 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 ing else which i
38a0: 73 20 6e 6f 74 20 61 6e 20 75 6e 61 62 69 67 75 s not an unabigu
38b0: 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f ous reference to
38c0: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 a database colu
38d0: 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 mn..*/.const cha
38e0: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d r *sqlite3_colum
38f0: 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28 73 71 6c n_table_name(sql
3900: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
3910: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 , int N){. retu
3920: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 rn columnName(pS
3930: 74 6d 74 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 tmt, N, (const v
3940: 6f 69 64 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 oid*(*)(Mem*))sq
3950: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 lite3_value_text
3960: 2c 20 33 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 , 3);.}.#ifndef
3970: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
3980: 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6.const void *sq
3990: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 lite3_column_tab
39a0: 6c 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 le_name16(sqlite
39b0: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 3_stmt *pStmt, i
39c0: 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 nt N){. return
39d0: 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 columnName(pStmt
39e0: 2c 20 4e 2c 20 28 63 6f 6e 73 74 20 76 6f 69 64 , N, (const void
39f0: 2a 28 2a 29 28 4d 65 6d 2a 29 29 73 71 6c 69 74 *(*)(Mem*))sqlit
3a00: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c e3_value_text16,
3a10: 20 33 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 3);.}.#endif /*
3a20: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
3a30: 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 16 */../*.** Ret
3a40: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 urn the name of
3a50: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e the table column
3a60: 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72 65 from which a re
3a70: 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69 sult column deri
3a80: 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 ves..** NULL is
3a90: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 returned if the
3aa0: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 result column is
3ab0: 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f an expression o
3ac0: 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a r constant or.**
3ad0: 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 77 anything else w
3ae0: 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20 75 hich is not an u
3af0: 6e 61 62 69 67 75 6f 75 73 20 72 65 66 65 72 65 nabiguous refere
3b00: 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61 73 nce to a databas
3b10: 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e e column..*/.con
3b20: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
3b30: 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e _column_origin_n
3b40: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 ame(sqlite3_stmt
3b50: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b *pStmt, int N){
3b60: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e . return column
3b70: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 Name(pStmt, N, (
3b80: 63 6f 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d const void*(*)(M
3b90: 65 6d 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c em*))sqlite3_val
3ba0: 75 65 5f 74 65 78 74 2c 20 34 29 3b 0a 7d 0a 23 ue_text, 4);.}.#
3bb0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
3bc0: 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 IT_UTF16.const v
3bd0: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c oid *sqlite3_col
3be0: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 umn_origin_name1
3bf0: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 6(sqlite3_stmt *
3c00: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 pStmt, int N){.
3c10: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 return columnNa
3c20: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 28 63 6f me(pStmt, N, (co
3c30: 6e 73 74 20 76 6f 69 64 2a 28 2a 29 28 4d 65 6d nst void*(*)(Mem
3c40: 2a 29 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 *))sqlite3_value
3c50: 5f 74 65 78 74 31 36 2c 20 34 29 3b 0a 7d 0a 23 _text16, 4);.}.#
3c60: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
3c70: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65 OMIT_UTF16 */.#e
3c80: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
3c90: 4d 49 54 5f 4f 52 49 47 49 4e 5f 4e 41 4d 45 53 MIT_ORIGIN_NAMES
3ca0: 20 2a 2f 0a 0a 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a */...../*******
3cb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3cc0: 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 ******** sqlite3
3cd0: 5f 62 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a _bind_ ********
3ce0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3cf0: 2a 2a 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74 69 ***.** .** Routi
3d00: 6e 65 73 20 75 73 65 64 20 74 6f 20 61 74 74 61 nes used to atta
3d10: 63 68 20 76 61 6c 75 65 73 20 74 6f 20 77 69 6c ch values to wil
3d20: 64 63 61 72 64 73 20 69 6e 20 61 20 63 6f 6d 70 dcards in a comp
3d30: 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 iled SQL stateme
3d40: 6e 74 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e 62 nt..*/./*.** Unb
3d50: 69 6e 64 20 74 68 65 20 76 61 6c 75 65 20 62 6f ind the value bo
3d60: 75 6e 64 20 74 6f 20 76 61 72 69 61 62 6c 65 20 und to variable
3d70: 69 20 69 6e 20 76 69 72 74 75 61 6c 20 6d 61 63 i in virtual mac
3d80: 68 69 6e 65 20 70 2e 20 54 68 69 73 20 69 73 20 hine p. This is
3d90: 74 68 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d 65 the .** the same
3da0: 20 61 73 20 62 69 6e 64 69 6e 67 20 61 20 4e 55 as binding a NU
3db0: 4c 4c 20 76 61 6c 75 65 20 74 6f 20 74 68 65 20 LL value to the
3dc0: 63 6f 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20 22 column. If the "
3dd0: 69 22 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a i" parameter is.
3de0: 2a 2a 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c ** out of range,
3df0: 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 52 41 4e then SQLITE_RAN
3e00: 47 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 GE is returned.
3e10: 4f 74 68 65 77 69 73 65 20 53 51 4c 49 54 45 5f Othewise SQLITE_
3e20: 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 72 OK..**.** The er
3e30: 72 6f 72 20 63 6f 64 65 20 73 74 6f 72 65 64 20 ror code stored
3e40: 69 6e 20 64 61 74 61 62 61 73 65 20 70 2d 3e 64 in database p->d
3e50: 62 20 69 73 20 6f 76 65 72 77 72 69 74 74 65 6e b is overwritten
3e60: 20 77 69 74 68 20 74 68 65 20 72 65 74 75 72 6e with the return
3e70: 0a 2a 2a 20 76 61 6c 75 65 20 69 6e 20 61 6e 79 .** value in any
3e80: 20 63 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 case..*/.static
3e90: 20 69 6e 74 20 76 64 62 65 55 6e 62 69 6e 64 28 int vdbeUnbind(
3ea0: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 29 7b Vdbe *p, int i){
3eb0: 0a 20 20 4d 65 6d 20 2a 70 56 61 72 3b 0a 20 20 . Mem *pVar;.
3ec0: 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6d if( p==0 || p->m
3ed0: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 agic!=VDBE_MAGIC
3ee0: 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70 63 3e 3d 30 _RUN || p->pc>=0
3ef0: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 20 29 20 ){. if( p )
3f00: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e sqlite3Error(p->
3f10: 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 db, SQLITE_MISUS
3f20: 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 72 E, 0);. retur
3f30: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b n SQLITE_MISUSE;
3f40: 0a 20 20 7d 0a 20 20 69 66 28 20 69 3c 31 20 7c . }. if( i<1 |
3f50: 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b 0a 20 | i>p->nVar ){.
3f60: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
3f70: 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 p->db, SQLITE_RA
3f80: 4e 47 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 NGE, 0);. ret
3f90: 75 72 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 urn SQLITE_RANGE
3fa0: 3b 0a 20 20 7d 0a 20 20 69 2d 2d 3b 0a 20 20 70 ;. }. i--;. p
3fb0: 56 61 72 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 Var = &p->aVar[i
3fc0: 5d 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 ];. sqlite3Vdbe
3fd0: 4d 65 6d 52 65 6c 65 61 73 65 28 70 56 61 72 29 MemRelease(pVar)
3fe0: 3b 0a 20 20 70 56 61 72 2d 3e 66 6c 61 67 73 20 ;. pVar->flags
3ff0: 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 71 = MEM_Null;. sq
4000: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 lite3Error(p->db
4010: 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b , SQLITE_OK, 0);
4020: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
4030: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69 _OK;.}../*.** Bi
4040: 6e 64 20 61 20 74 65 78 74 20 6f 72 20 42 4c 4f nd a text or BLO
4050: 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 B value..*/.stat
4060: 69 63 20 69 6e 74 20 62 69 6e 64 54 65 78 74 28 ic int bindText(
4070: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 . sqlite3_stmt
4080: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 *pStmt, . int i
4090: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 , . const void
40a0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e *zData, . int n
40b0: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a Data, . void (*
40c0: 78 44 65 6c 29 28 76 6f 69 64 2a 29 2c 0a 20 20 xDel)(void*),.
40d0: 69 6e 74 20 65 6e 63 6f 64 69 6e 67 0a 29 7b 0a int encoding.){.
40e0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 Vdbe *p = (Vdb
40f0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d e *)pStmt;. Mem
4100: 20 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63 *pVar;. int rc
4110: 3b 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e ;.. rc = vdbeUn
4120: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 bind(p, i);. if
4130: 28 20 72 63 20 7c 7c 20 7a 44 61 74 61 3d 3d 30 ( rc || zData==0
4140: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 ){. return r
4150: 63 3b 0a 20 20 7d 0a 20 20 70 56 61 72 20 3d 20 c;. }. pVar =
4160: 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b 0a 20 &p->aVar[i-1];.
4170: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 rc = sqlite3Vdb
4180: 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61 72 2c eMemSetStr(pVar,
4190: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 65 zData, nData, e
41a0: 6e 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29 3b 0a ncoding, xDel);.
41b0: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
41c0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 return rc;. }.
41d0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
41e0: 4f 4b 20 26 26 20 65 6e 63 6f 64 69 6e 67 21 3d OK && encoding!=
41f0: 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 0 ){. rc = sq
4200: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 45 lite3VdbeChangeE
4210: 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20 70 2d ncoding(pVar, p-
4220: 3e 64 62 2d 3e 65 6e 63 29 3b 0a 20 20 7d 0a 20 >db->enc);. }.
4230: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
4240: 2f 2a 0a 2a 2a 20 42 69 6e 64 20 61 20 62 6c 6f /*.** Bind a blo
4250: 62 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 53 51 b value to an SQ
4260: 4c 20 73 74 61 74 65 6d 65 6e 74 20 76 61 72 69 L statement vari
4270: 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c able..*/.int sql
4280: 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 0a ite3_bind_blob(.
4290: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
42a0: 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c pStmt, . int i,
42b0: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a . const void *
42c0: 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e 44 zData, . int nD
42d0: 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 ata, . void (*x
42e0: 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 Del)(void*).){.
42f0: 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74 return bindText
4300: 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 (pStmt, i, zData
4310: 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 , nData, xDel, 0
4320: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 );.}.int sqlite3
4330: 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73 71 6c _bind_double(sql
4340: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
4350: 2c 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c 65 20 , int i, double
4360: 72 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 rValue){. int r
4370: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 c;. Vdbe *p = (
4380: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 Vdbe *)pStmt;.
4390: 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 rc = vdbeUnbind(
43a0: 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d p, i);. if( rc=
43b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
43c0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d sqlite3VdbeMem
43d0: 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e 61 56 SetDouble(&p->aV
43e0: 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75 65 29 ar[i-1], rValue)
43f0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
4400: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 c;.}.int sqlite3
4410: 5f 62 69 6e 64 5f 69 6e 74 28 73 71 6c 69 74 65 _bind_int(sqlite
4420: 33 5f 73 74 6d 74 20 2a 70 2c 20 69 6e 74 20 69 3_stmt *p, int i
4430: 2c 20 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a 20 , int iValue){.
4440: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f return sqlite3_
4450: 62 69 6e 64 5f 69 6e 74 36 34 28 70 2c 20 69 2c bind_int64(p, i,
4460: 20 28 69 36 34 29 69 56 61 6c 75 65 29 3b 0a 7d (i64)iValue);.}
4470: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e .int sqlite3_bin
4480: 64 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f d_int64(sqlite3_
4490: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 stmt *pStmt, int
44a0: 20 69 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 i, sqlite_int64
44b0: 20 69 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 iValue){. int
44c0: 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 rc;. Vdbe *p =
44d0: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 (Vdbe *)pStmt;.
44e0: 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 rc = vdbeUnbind
44f0: 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 (p, i);. if( rc
4500: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
4510: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 sqlite3VdbeMe
4520: 6d 53 65 74 49 6e 74 36 34 28 26 70 2d 3e 61 56 mSetInt64(&p->aV
4530: 61 72 5b 69 2d 31 5d 2c 20 69 56 61 6c 75 65 29 ar[i-1], iValue)
4540: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
4550: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 c;.}.int sqlite3
4560: 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74 _bind_null(sqlit
4570: 65 33 5f 73 74 6d 74 2a 20 70 2c 20 69 6e 74 20 e3_stmt* p, int
4580: 69 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 64 62 i){. return vdb
4590: 65 55 6e 62 69 6e 64 28 28 56 64 62 65 20 2a 29 eUnbind((Vdbe *)
45a0: 70 2c 20 69 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c p, i);.}.int sql
45b0: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28 20 ite3_bind_text(
45c0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 . sqlite3_stmt
45d0: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 *pStmt, . int i
45e0: 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 , . const char
45f0: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e *zData, . int n
4600: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a Data, . void (*
4610: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a xDel)(void*).){.
4620: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78 return bindTex
4630: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 t(pStmt, i, zDat
4640: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 a, nData, xDel,
4650: 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a SQLITE_UTF8);.}.
4660: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
4670: 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 MIT_UTF16.int sq
4680: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 lite3_bind_text1
4690: 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 6(. sqlite3_stm
46a0: 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 t *pStmt, . int
46b0: 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 i, . const voi
46c0: 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 d *zData, . int
46d0: 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 nData, . void
46e0: 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 (*xDel)(void*).)
46f0: 7b 0a 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 {. return bindT
4700: 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 ext(pStmt, i, zD
4710: 61 74 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c ata, nData, xDel
4720: 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 , SQLITE_UTF16NA
4730: 54 49 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 TIVE);.}.#endif
4740: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
4750: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
4760: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 eturn the number
4770: 20 6f 66 20 77 69 6c 64 63 61 72 64 73 20 74 68 of wildcards th
4780: 61 74 20 63 61 6e 20 62 65 20 70 6f 74 65 6e 74 at can be potent
4790: 69 61 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e 0a ially bound to..
47a0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
47b0: 69 73 20 61 64 64 65 64 20 74 6f 20 73 75 70 70 is added to supp
47c0: 6f 72 74 20 44 42 44 3a 3a 53 51 4c 69 74 65 2e ort DBD::SQLite.
47d0: 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 .*/.int sqlite
47e0: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 3_bind_parameter
47f0: 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 _count(sqlite3_s
4800: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 tmt *pStmt){. V
4810: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 dbe *p = (Vdbe*)
4820: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 pStmt;. return
4830: 70 20 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30 3b p ? p->nVar : 0;
4840: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 .}../*.** Create
4850: 20 61 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20 a mapping from
4860: 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 73 variable numbers
4870: 20 74 6f 20 76 61 72 69 61 62 6c 65 20 6e 61 6d to variable nam
4880: 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 64 62 es.** in the Vdb
4890: 65 2e 61 7a 56 61 72 5b 5d 20 61 72 72 61 79 2c e.azVar[] array,
48a0: 20 69 66 20 73 75 63 68 20 61 20 6d 61 70 70 69 if such a mappi
48b0: 6e 67 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65 ng does not alre
48c0: 61 64 79 0a 2a 2a 20 65 78 69 73 74 2e 0a 2a 2f ady.** exist..*/
48d0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 72 65 .static void cre
48e0: 61 74 65 56 61 72 4d 61 70 28 56 64 62 65 20 2a ateVarMap(Vdbe *
48f0: 70 29 7b 0a 20 20 69 66 28 20 21 70 2d 3e 6f 6b p){. if( !p->ok
4900: 56 61 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 6a Var ){. int j
4910: 3b 0a 20 20 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 ;. Op *pOp;.
4920: 20 20 20 66 6f 72 28 6a 3d 30 2c 20 70 4f 70 3d for(j=0, pOp=
4930: 70 2d 3e 61 4f 70 3b 20 6a 3c 70 2d 3e 6e 4f 70 p->aOp; j<p->nOp
4940: 3b 20 6a 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20 ; j++, pOp++){.
4950: 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 if( pOp->op
4960: 63 6f 64 65 3d 3d 4f 50 5f 56 61 72 69 61 62 6c code==OP_Variabl
4970: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 e ){. ass
4980: 65 72 74 28 20 70 4f 70 2d 3e 70 31 3e 30 20 26 ert( pOp->p1>0 &
4990: 26 20 70 4f 70 2d 3e 70 31 3c 3d 70 2d 3e 6e 56 & pOp->p1<=p->nV
49a0: 61 72 20 29 3b 0a 20 20 20 20 20 20 20 20 70 2d ar );. p-
49b0: 3e 61 7a 56 61 72 5b 70 4f 70 2d 3e 70 31 2d 31 >azVar[pOp->p1-1
49c0: 5d 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 ] = pOp->p3;.
49d0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 }. }. p
49e0: 2d 3e 6f 6b 56 61 72 20 3d 20 31 3b 0a 20 20 7d ->okVar = 1;. }
49f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
4a00: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 77 the name of a w
4a10: 69 6c 64 63 61 72 64 20 70 61 72 61 6d 65 74 65 ildcard paramete
4a20: 72 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 r. Return NULL
4a30: 69 66 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 if the index.**
4a40: 69 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 20 is out of range
4a50: 6f 72 20 69 66 20 74 68 65 20 77 69 6c 64 63 61 or if the wildca
4a60: 72 64 20 69 73 20 75 6e 6e 61 6d 65 64 2e 0a 2a rd is unnamed..*
4a70: 2a 0a 2a 2a 20 54 68 65 20 72 65 73 75 6c 74 20 *.** The result
4a80: 69 73 20 61 6c 77 61 79 73 20 55 54 46 2d 38 2e is always UTF-8.
4a90: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
4aa0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 sqlite3_bind_par
4ab0: 61 6d 65 74 65 72 5f 6e 61 6d 65 28 73 71 6c 69 ameter_name(sqli
4ac0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c te3_stmt *pStmt,
4ad0: 20 69 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20 int i){. Vdbe
4ae0: 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d *p = (Vdbe*)pStm
4af0: 74 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c t;. if( p==0 ||
4b00: 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61 i<1 || i>p->nVa
4b10: 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 r ){. return
4b20: 30 3b 0a 20 20 7d 0a 20 20 63 72 65 61 74 65 56 0;. }. createV
4b30: 61 72 4d 61 70 28 70 29 3b 0a 20 20 72 65 74 75 arMap(p);. retu
4b40: 72 6e 20 70 2d 3e 61 7a 56 61 72 5b 69 2d 31 5d rn p->azVar[i-1]
4b50: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e ;.}../*.** Given
4b60: 20 61 20 77 69 6c 64 63 61 72 64 20 70 61 72 61 a wildcard para
4b70: 6d 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74 75 meter name, retu
4b80: 72 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 rn the index of
4b90: 74 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 the variable.**
4ba0: 77 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e 20 with that name.
4bb0: 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 If there is no
4bc0: 76 61 72 69 61 62 6c 65 20 77 69 74 68 20 74 68 variable with th
4bd0: 65 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a e given name,.**
4be0: 20 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e return 0..*/.in
4bf0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 t sqlite3_bind_p
4c00: 61 72 61 6d 65 74 65 72 5f 69 6e 64 65 78 28 73 arameter_index(s
4c10: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 qlite3_stmt *pSt
4c20: 6d 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a mt, const char *
4c30: 7a 4e 61 6d 65 29 7b 0a 20 20 56 64 62 65 20 2a zName){. Vdbe *
4c40: 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 p = (Vdbe*)pStmt
4c50: 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 ;. int i;. if(
4c60: 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 p==0 ){. ret
4c70: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 63 72 65 urn 0;. }. cre
4c80: 61 74 65 56 61 72 4d 61 70 28 70 29 3b 20 0a 20 ateVarMap(p); .
4c90: 20 69 66 28 20 7a 4e 61 6d 65 20 29 7b 0a 20 20 if( zName ){.
4ca0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e for(i=0; i<p->
4cb0: 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 nVar; i++){.
4cc0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 const char *z
4cd0: 3d 20 70 2d 3e 61 7a 56 61 72 5b 69 5d 3b 0a 20 = p->azVar[i];.
4ce0: 20 20 20 20 20 69 66 28 20 7a 20 26 26 20 73 74 if( z && st
4cf0: 72 63 6d 70 28 7a 2c 7a 4e 61 6d 65 29 3d 3d 30 rcmp(z,zName)==0
4d00: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ){. retu
4d10: 72 6e 20 69 2b 31 3b 0a 20 20 20 20 20 20 7d 0a rn i+1;. }.
4d20: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
4d30: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 rn 0;.}../*.** T
4d40: 72 61 6e 73 66 65 72 20 61 6c 6c 20 62 69 6e 64 ransfer all bind
4d50: 69 6e 67 73 20 66 72 6f 6d 20 74 68 65 20 66 69 ings from the fi
4d60: 72 73 74 20 73 74 61 74 65 6d 65 6e 74 20 6f 76 rst statement ov
4d70: 65 72 20 74 6f 20 74 68 65 20 73 65 63 6f 6e 64 er to the second
4d80: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 74 77 6f 20 ..** If the two
4d90: 73 74 61 74 65 6d 65 6e 74 73 20 63 6f 6e 74 61 statements conta
4da0: 69 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20 6e in a different n
4db0: 75 6d 62 65 72 20 6f 66 20 62 69 6e 64 69 6e 67 umber of binding
4dc0: 73 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 20 53 51 s, then.** an SQ
4dd0: 4c 49 54 45 5f 45 52 52 4f 52 20 69 73 20 72 65 LITE_ERROR is re
4de0: 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 turned..*/.int s
4df0: 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72 5f qlite3_transfer_
4e00: 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 bindings(sqlite3
4e10: 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d 74 _stmt *pFromStmt
4e20: 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a , sqlite3_stmt *
4e30: 70 54 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 pToStmt){. Vdbe
4e40: 20 2a 70 46 72 6f 6d 20 3d 20 28 56 64 62 65 2a *pFrom = (Vdbe*
4e50: 29 70 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 )pFromStmt;. Vd
4e60: 62 65 20 2a 70 54 6f 20 3d 20 28 56 64 62 65 2a be *pTo = (Vdbe*
4e70: 29 70 54 6f 53 74 6d 74 3b 0a 20 20 69 6e 74 20 )pToStmt;. int
4e80: 69 2c 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f i, rc = SQLITE_O
4e90: 4b 3b 0a 20 20 69 66 28 20 28 70 46 72 6f 6d 2d K;. if( (pFrom-
4ea0: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 >magic!=VDBE_MAG
4eb0: 49 43 5f 52 55 4e 20 26 26 20 70 46 72 6f 6d 2d IC_RUN && pFrom-
4ec0: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 >magic!=VDBE_MAG
4ed0: 49 43 5f 48 41 4c 54 29 0a 20 20 20 20 7c 7c 20 IC_HALT). ||
4ee0: 28 70 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42 (pTo->magic!=VDB
4ef0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20 70 E_MAGIC_RUN && p
4f00: 54 6f 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f To->magic!=VDBE_
4f10: 4d 41 47 49 43 5f 48 41 4c 54 29 20 29 7b 0a 20 MAGIC_HALT) ){.
4f20: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
4f30: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 _MISUSE;. }. i
4f40: 66 28 20 70 46 72 6f 6d 2d 3e 6e 56 61 72 21 3d f( pFrom->nVar!=
4f50: 70 54 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 pTo->nVar ){.
4f60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 return SQLITE_E
4f70: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 RROR;. }. for(
4f80: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f i=0; rc==SQLITE_
4f90: 4f 4b 20 26 26 20 69 3c 70 46 72 6f 6d 2d 3e 6e OK && i<pFrom->n
4fa0: 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 72 Var; i++){. r
4fb0: 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d c = sqlite3VdbeM
4fc0: 65 6d 4d 6f 76 65 28 26 70 54 6f 2d 3e 61 56 61 emMove(&pTo->aVa
4fd0: 72 5b 69 5d 2c 20 26 70 46 72 6f 6d 2d 3e 61 56 r[i], &pFrom->aV
4fe0: 61 72 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 72 65 ar[i]);. }. re
4ff0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
5000: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 71 6c * Return the sql
5010: 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20 68 ite3* database h
5020: 61 6e 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74 andle to which t
5030: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 he prepared stat
5040: 65 6d 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 69 ement given.** i
5050: 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 62 n the argument b
5060: 65 6c 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 73 elongs. This is
5070: 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 the same databa
5080: 73 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 77 se handle that w
5090: 61 73 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 as.** the first
50a0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the
50b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 sqlite3_prepare(
50c0: 29 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20 ) that was used
50d0: 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 65 to create.** the
50e0: 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68 statement in th
50f0: 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 2a e first place..*
5100: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74 /.sqlite3 *sqlit
5110: 65 33 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c e3_db_handle(sql
5120: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 ite3_stmt *pStmt
5130: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d ){. return pStm
5140: 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d t ? ((Vdbe*)pStm
5150: 74 29 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a t)->db : 0;.}.