0000: 2f 2a 0a 2a 2a 20 32 30 30 36 20 4a 75 6e 65 20 /*.** 2006 June
0010: 31 30 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 10.**.** The aut
0020: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f hor disclaims co
0030: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 pyright to this
0040: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e source code. In
0050: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c place of.** a l
0060: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 egal notice, her
0070: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a e is a blessing:
0080: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f .**.** May yo
0090: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f u do good and no
00a0: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 t evil..** Ma
00b0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 y you find forgi
00c0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 veness for yours
00d0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 elf and forgive
00e0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 others..** Ma
00f0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 y you share free
0100: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 ly, never taking
0110: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 more than you g
0120: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a ive..**.********
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: 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 *.** This file c
0180: 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75 73 65 ontains code use
0190: 64 20 74 6f 20 68 65 6c 70 20 69 6d 70 6c 65 6d d to help implem
01a0: 65 6e 74 20 76 69 72 74 75 61 6c 20 74 61 62 6c ent virtual tabl
01b0: 65 73 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 76 es..**.** $Id: v
01c0: 74 61 62 2e 63 2c 76 20 31 2e 33 39 20 32 30 30 tab.c,v 1.39 200
01d0: 37 2f 30 31 2f 30 39 20 31 34 3a 30 31 3a 31 34 7/01/09 14:01:14
01e0: 20 64 72 68 20 45 78 70 20 24 0a 2a 2f 0a 23 69 drh Exp $.*/.#i
01f0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
0200: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 T_VIRTUALTABLE.#
0210: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 include "sqliteI
0220: 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 nt.h"../*.** Ext
0230: 65 72 6e 61 6c 20 41 50 49 20 66 75 6e 63 74 69 ernal API functi
0240: 6f 6e 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 on used to creat
0250: 65 20 61 20 6e 65 77 20 76 69 72 74 75 61 6c 2d e a new virtual-
0260: 74 61 62 6c 65 20 6d 6f 64 75 6c 65 2e 0a 2a 2f table module..*/
0270: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
0280: 61 74 65 5f 6d 6f 64 75 6c 65 28 0a 20 20 73 71 ate_module(. sq
0290: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
02a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
02b0: 20 44 61 74 61 62 61 73 65 20 69 6e 20 77 68 69 Database in whi
02c0: 63 68 20 6d 6f 64 75 6c 65 20 69 73 20 72 65 67 ch module is reg
02d0: 69 73 74 65 72 65 64 20 2a 2f 0a 20 20 63 6f 6e istered */. con
02e0: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 st char *zName,
02f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
0300: 4e 61 6d 65 20 61 73 73 69 67 6e 65 64 20 74 6f Name assigned to
0310: 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a this module */.
0320: 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f const sqlite3_
0330: 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 2c module *pModule,
0340: 20 20 2f 2a 20 54 68 65 20 64 65 66 69 6e 69 74 /* The definit
0350: 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 64 75 6c ion of the modul
0360: 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 e */. void *pAu
0370: 78 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x
0380: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78 /* Contex
0390: 74 20 70 6f 69 6e 74 65 72 20 66 6f 72 20 78 43 t pointer for xC
03a0: 72 65 61 74 65 2f 78 43 6f 6e 6e 65 63 74 20 2a reate/xConnect *
03b0: 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 /.){. int nName
03c0: 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 = strlen(zName)
03d0: 3b 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 ;. Module *pMod
03e0: 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c = (Module *)sql
03f0: 69 74 65 4d 61 6c 6c 6f 63 52 61 77 28 73 69 7a iteMallocRaw(siz
0400: 65 6f 66 28 4d 6f 64 75 6c 65 29 20 2b 20 6e 4e eof(Module) + nN
0410: 61 6d 65 20 2b 20 31 29 3b 0a 20 20 69 66 28 20 ame + 1);. if(
0420: 70 4d 6f 64 20 29 7b 0a 20 20 20 20 63 68 61 72 pMod ){. char
0430: 20 2a 7a 43 6f 70 79 20 3d 20 28 63 68 61 72 20 *zCopy = (char
0440: 2a 29 28 26 70 4d 6f 64 5b 31 5d 29 3b 0a 20 20 *)(&pMod[1]);.
0450: 20 20 73 74 72 63 70 79 28 7a 43 6f 70 79 2c 20 strcpy(zCopy,
0460: 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 70 4d 6f 64 zName);. pMod
0470: 2d 3e 7a 4e 61 6d 65 20 3d 20 7a 43 6f 70 79 3b ->zName = zCopy;
0480: 0a 20 20 20 20 70 4d 6f 64 2d 3e 70 4d 6f 64 75 . pMod->pModu
0490: 6c 65 20 3d 20 70 4d 6f 64 75 6c 65 3b 0a 20 20 le = pModule;.
04a0: 20 20 70 4d 6f 64 2d 3e 70 41 75 78 20 3d 20 70 pMod->pAux = p
04b0: 41 75 78 3b 0a 20 20 20 20 70 4d 6f 64 20 3d 20 Aux;. pMod =
04c0: 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 (Module *)sqlite
04d0: 33 48 61 73 68 49 6e 73 65 72 74 28 26 64 62 2d 3HashInsert(&db-
04e0: 3e 61 4d 6f 64 75 6c 65 2c 20 7a 43 6f 70 79 2c >aModule, zCopy,
04f0: 20 6e 4e 61 6d 65 2c 20 28 76 6f 69 64 2a 29 70 nName, (void*)p
0500: 4d 6f 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 Mod);. sqlite
0510: 46 72 65 65 28 70 4d 6f 64 29 3b 0a 20 20 20 20 Free(pMod);.
0520: 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 sqlite3ResetInte
0530: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 rnalSchema(db, 0
0540: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
0550: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
0560: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 7d b, SQLITE_OK);.}
0570: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 ../*.** Lock the
0580: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 73 virtual table s
0590: 6f 20 74 68 61 74 20 69 74 20 63 61 6e 6e 6f 74 o that it cannot
05a0: 20 62 65 20 64 69 73 63 6f 6e 6e 65 63 74 65 64 be disconnected
05b0: 2e 0a 2a 2a 20 4c 6f 63 6b 73 20 6e 65 73 74 2e ..** Locks nest.
05c0: 20 20 45 76 65 72 79 20 6c 6f 63 6b 20 73 68 6f Every lock sho
05d0: 75 6c 64 20 68 61 76 65 20 61 20 63 6f 72 72 65 uld have a corre
05e0: 73 70 6f 6e 64 69 6e 67 20 75 6e 6c 6f 63 6b 2e sponding unlock.
05f0: 0a 2a 2a 20 49 66 20 61 6e 20 75 6e 6c 6f 63 6b .** If an unlock
0600: 20 69 73 20 6f 6d 69 74 74 65 64 2c 20 72 65 73 is omitted, res
0610: 6f 75 72 63 65 73 20 6c 65 61 6b 73 20 77 69 6c ources leaks wil
0620: 6c 20 6f 63 63 75 72 2e 20 20 0a 2a 2a 0a 2a 2a l occur. .**.**
0630: 20 49 66 20 61 20 64 69 73 63 6f 6e 6e 65 63 74 If a disconnect
0640: 20 69 73 20 61 74 74 65 6d 70 74 65 64 20 77 68 is attempted wh
0650: 69 6c 65 20 61 20 76 69 72 74 75 61 6c 20 74 61 ile a virtual ta
0660: 62 6c 65 20 69 73 20 6c 6f 63 6b 65 64 2c 0a 2a ble is locked,.*
0670: 2a 20 74 68 65 20 64 69 73 63 6f 6e 6e 65 63 74 * the disconnect
0680: 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e 74 is deferred unt
0690: 69 6c 20 61 6c 6c 20 6c 6f 63 6b 73 20 68 61 76 il all locks hav
06a0: 65 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 2e 0a e been removed..
06b0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 */.void sqlite3V
06c0: 74 61 62 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f tabLock(sqlite3_
06d0: 76 74 61 62 20 2a 70 56 74 61 62 29 7b 0a 20 20 vtab *pVtab){.
06e0: 70 56 74 61 62 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d pVtab->nRef++;.}
06f0: 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b 20 61 ../*.** Unlock a
0700: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 virtual table.
0710: 20 57 68 65 6e 20 74 68 65 20 6c 61 73 74 20 6c When the last l
0720: 6f 63 6b 20 69 73 20 72 65 6d 6f 76 65 64 2c 0a ock is removed,.
0730: 2a 2a 20 64 69 73 63 6f 6e 6e 65 63 74 20 74 68 ** disconnect th
0740: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e e virtual table.
0750: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
0760: 56 74 61 62 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 VtabUnlock(sqlit
0770: 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 29 7b e3_vtab *pVtab){
0780: 0a 20 20 70 56 74 61 62 2d 3e 6e 52 65 66 2d 2d . pVtab->nRef--
0790: 3b 0a 20 20 69 66 28 20 70 56 74 61 62 2d 3e 6e ;. if( pVtab->n
07a0: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 70 56 Ref==0 ){. pV
07b0: 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 44 tab->pModule->xD
07c0: 69 73 63 6f 6e 6e 65 63 74 28 70 56 74 61 62 29 isconnect(pVtab)
07d0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 ;. }.}../*.** C
07e0: 6c 65 61 72 20 61 6e 79 20 61 6e 64 20 61 6c 6c lear any and all
07f0: 20 76 69 72 74 75 61 6c 2d 74 61 62 6c 65 20 69 virtual-table i
0800: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 nformation from
0810: 74 68 65 20 54 61 62 6c 65 20 72 65 63 6f 72 64 the Table record
0820: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e ..** This routin
0830: 65 20 69 73 20 63 61 6c 6c 65 64 2c 20 66 6f 72 e is called, for
0840: 20 65 78 61 6d 70 6c 65 2c 20 6a 75 73 74 20 62 example, just b
0850: 65 66 6f 72 65 20 64 65 6c 65 74 69 6e 67 20 74 efore deleting t
0860: 68 65 20 54 61 62 6c 65 0a 2a 2a 20 72 65 63 6f he Table.** reco
0870: 72 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 rd..*/.void sqli
0880: 74 65 33 56 74 61 62 43 6c 65 61 72 28 54 61 62 te3VtabClear(Tab
0890: 6c 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65 le *p){. sqlite
08a0: 33 5f 76 74 61 62 20 2a 70 56 74 61 62 20 3d 20 3_vtab *pVtab =
08b0: 70 2d 3e 70 56 74 61 62 3b 0a 20 20 69 66 28 20 p->pVtab;. if(
08c0: 70 56 74 61 62 20 29 7b 0a 20 20 20 20 61 73 73 pVtab ){. ass
08d0: 65 72 74 28 20 70 2d 3e 70 4d 6f 64 20 26 26 20 ert( p->pMod &&
08e0: 70 2d 3e 70 4d 6f 64 2d 3e 70 4d 6f 64 75 6c 65 p->pMod->pModule
08f0: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 );. sqlite3V
0900: 74 61 62 55 6e 6c 6f 63 6b 28 70 56 74 61 62 29 tabUnlock(pVtab)
0910: 3b 0a 20 20 20 20 70 2d 3e 70 56 74 61 62 20 3d ;. p->pVtab =
0920: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 0;. }. if( p-
0930: 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 20 29 7b 0a >azModuleArg ){.
0940: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66 int i;. f
0950: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4d 6f or(i=0; i<p->nMo
0960: 64 75 6c 65 41 72 67 3b 20 69 2b 2b 29 7b 0a 20 duleArg; i++){.
0970: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 sqliteFree(
0980: 70 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 69 p->azModuleArg[i
0990: 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 ]);. }. sq
09a0: 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 7a 4d 6f liteFree(p->azMo
09b0: 64 75 6c 65 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a duleArg);. }.}.
09c0: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6e 65 77 ./*.** Add a new
09d0: 20 6d 6f 64 75 6c 65 20 61 72 67 75 6d 65 6e 74 module argument
09e0: 20 74 6f 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f to pTable->azMo
09f0: 64 75 6c 65 41 72 67 5b 5d 2e 0a 2a 2a 20 54 68 duleArg[]..** Th
0a00: 65 20 73 74 72 69 6e 67 20 69 73 20 6e 6f 74 20 e string is not
0a10: 63 6f 70 69 65 64 20 2d 20 74 68 65 20 70 6f 69 copied - the poi
0a20: 6e 74 65 72 20 69 73 20 73 74 6f 72 65 64 2e 20 nter is stored.
0a30: 20 54 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 77 The.** string w
0a40: 69 6c 6c 20 62 65 20 66 72 65 65 64 20 61 75 74 ill be freed aut
0a50: 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 6e 20 omatically when
0a60: 74 68 65 20 74 61 62 6c 65 20 69 73 0a 2a 2a 20 the table is.**
0a70: 64 65 6c 65 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 deleted..*/.stat
0a80: 69 63 20 76 6f 69 64 20 61 64 64 4d 6f 64 75 6c ic void addModul
0a90: 65 41 72 67 75 6d 65 6e 74 28 54 61 62 6c 65 20 eArgument(Table
0aa0: 2a 70 54 61 62 6c 65 2c 20 63 68 61 72 20 2a 7a *pTable, char *z
0ab0: 41 72 67 29 7b 0a 20 20 69 6e 74 20 69 20 3d 20 Arg){. int i =
0ac0: 70 54 61 62 6c 65 2d 3e 6e 4d 6f 64 75 6c 65 41 pTable->nModuleA
0ad0: 72 67 2b 2b 3b 0a 20 20 69 6e 74 20 6e 42 79 74 rg++;. int nByt
0ae0: 65 73 20 3d 20 73 69 7a 65 6f 66 28 63 68 61 72 es = sizeof(char
0af0: 20 2a 29 2a 28 31 2b 70 54 61 62 6c 65 2d 3e 6e *)*(1+pTable->n
0b00: 4d 6f 64 75 6c 65 41 72 67 29 3b 0a 20 20 63 68 ModuleArg);. ch
0b10: 61 72 20 2a 2a 61 7a 4d 6f 64 75 6c 65 41 72 67 ar **azModuleArg
0b20: 3b 0a 20 20 61 7a 4d 6f 64 75 6c 65 41 72 67 20 ;. azModuleArg
0b30: 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28 = sqliteRealloc(
0b40: 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 pTable->azModule
0b50: 41 72 67 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 Arg, nBytes);.
0b60: 69 66 28 20 61 7a 4d 6f 64 75 6c 65 41 72 67 3d if( azModuleArg=
0b70: 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6a 3b =0 ){. int j;
0b80: 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c . for(j=0; j<
0b90: 69 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 73 i; j++){. s
0ba0: 71 6c 69 74 65 46 72 65 65 28 70 54 61 62 6c 65 qliteFree(pTable
0bb0: 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 6a 5d ->azModuleArg[j]
0bc0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c );. }. sql
0bd0: 69 74 65 46 72 65 65 28 7a 41 72 67 29 3b 0a 20 iteFree(zArg);.
0be0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 54 sqliteFree(pT
0bf0: 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 able->azModuleAr
0c00: 67 29 3b 0a 20 20 20 20 70 54 61 62 6c 65 2d 3e g);. pTable->
0c10: 6e 4d 6f 64 75 6c 65 41 72 67 20 3d 20 30 3b 0a nModuleArg = 0;.
0c20: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 7a 4d }else{. azM
0c30: 6f 64 75 6c 65 41 72 67 5b 69 5d 20 3d 20 7a 41 oduleArg[i] = zA
0c40: 72 67 3b 0a 20 20 20 20 61 7a 4d 6f 64 75 6c 65 rg;. azModule
0c50: 41 72 67 5b 69 2b 31 5d 20 3d 20 30 3b 0a 20 20 Arg[i+1] = 0;.
0c60: 7d 0a 20 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f }. pTable->azMo
0c70: 64 75 6c 65 41 72 67 20 3d 20 61 7a 4d 6f 64 75 duleArg = azModu
0c80: 6c 65 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 leArg;.}../*.**
0c90: 54 68 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73 The parser calls
0ca0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 this routine wh
0cb0: 65 6e 20 69 74 20 66 69 72 73 74 20 73 65 65 73 en it first sees
0cc0: 20 61 20 43 52 45 41 54 45 20 56 49 52 54 55 41 a CREATE VIRTUA
0cd0: 4c 20 54 41 42 4c 45 0a 2a 2a 20 73 74 61 74 65 L TABLE.** state
0ce0: 6d 65 6e 74 2e 20 20 54 68 65 20 6d 6f 64 75 6c ment. The modul
0cf0: 65 20 6e 61 6d 65 20 68 61 73 20 62 65 65 6e 20 e name has been
0d00: 70 61 72 73 65 64 2c 20 62 75 74 20 74 68 65 20 parsed, but the
0d10: 6f 70 74 69 6f 6e 61 6c 20 6c 69 73 74 0a 2a 2a optional list.**
0d20: 20 6f 66 20 70 61 72 61 6d 65 74 65 72 73 20 74 of parameters t
0d30: 68 61 74 20 66 6f 6c 6c 6f 77 20 74 68 65 20 6d hat follow the m
0d40: 6f 64 75 6c 65 20 6e 61 6d 65 20 61 72 65 20 73 odule name are s
0d50: 74 69 6c 6c 20 70 65 6e 64 69 6e 67 2e 0a 2a 2f till pending..*/
0d60: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 .void sqlite3Vta
0d70: 62 42 65 67 69 6e 50 61 72 73 65 28 0a 20 20 50 bBeginParse(. P
0d80: 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 arse *pParse,
0d90: 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 20 /* Parsing
0da0: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 6f 6b context */. Tok
0db0: 65 6e 20 2a 70 4e 61 6d 65 31 2c 20 20 20 20 20 en *pName1,
0dc0: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 6e 65 /* Name of ne
0dd0: 77 20 74 61 62 6c 65 2c 20 6f 72 20 64 61 74 61 w table, or data
0de0: 62 61 73 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 54 base name */. T
0df0: 6f 6b 65 6e 20 2a 70 4e 61 6d 65 32 2c 20 20 20 oken *pName2,
0e00: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
0e10: 6e 65 77 20 74 61 62 6c 65 20 6f 72 20 4e 55 4c new table or NUL
0e20: 4c 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 2a 70 4d L */. Token *pM
0e30: 6f 64 75 6c 65 4e 61 6d 65 20 20 20 20 2f 2a 20 oduleName /*
0e40: 4e 61 6d 65 20 6f 66 20 74 68 65 20 6d 6f 64 75 Name of the modu
0e50: 6c 65 20 66 6f 72 20 74 68 65 20 76 69 72 74 75 le for the virtu
0e60: 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 29 7b 0a 20 al table */.){.
0e70: 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 20 20 int iDb;
0e80: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 /* The da
0e90: 74 61 62 61 73 65 20 74 68 65 20 74 61 62 6c 65 tabase the table
0ea0: 20 69 73 20 62 65 69 6e 67 20 63 72 65 61 74 65 is being create
0eb0: 64 20 69 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 d in */. Table
0ec0: 2a 70 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 *pTable;
0ed0: 2f 2a 20 54 68 65 20 6e 65 77 20 76 69 72 74 75 /* The new virtu
0ee0: 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 0a 20 20 73 al table */.. s
0ef0: 71 6c 69 74 65 33 53 74 61 72 74 54 61 62 6c 65 qlite3StartTable
0f00: 28 70 50 61 72 73 65 2c 20 70 4e 61 6d 65 31 2c (pParse, pName1,
0f10: 20 70 4e 61 6d 65 32 2c 20 30 2c 20 30 2c 20 31 pName2, 0, 0, 1
0f20: 2c 20 30 29 3b 0a 20 20 70 54 61 62 6c 65 20 3d , 0);. pTable =
0f30: 20 70 50 61 72 73 65 2d 3e 70 4e 65 77 54 61 62 pParse->pNewTab
0f40: 6c 65 3b 0a 20 20 69 66 28 20 70 54 61 62 6c 65 le;. if( pTable
0f50: 3d 3d 30 20 7c 7c 20 70 50 61 72 73 65 2d 3e 6e ==0 || pParse->n
0f60: 45 72 72 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 Err ) return;.
0f70: 61 73 73 65 72 74 28 20 30 3d 3d 70 54 61 62 6c assert( 0==pTabl
0f80: 65 2d 3e 70 49 6e 64 65 78 20 29 3b 0a 0a 20 20 e->pIndex );..
0f90: 69 44 62 20 3d 20 73 71 6c 69 74 65 33 53 63 68 iDb = sqlite3Sch
0fa0: 65 6d 61 54 6f 49 6e 64 65 78 28 70 50 61 72 73 emaToIndex(pPars
0fb0: 65 2d 3e 64 62 2c 20 70 54 61 62 6c 65 2d 3e 70 e->db, pTable->p
0fc0: 53 63 68 65 6d 61 29 3b 0a 20 20 61 73 73 65 72 Schema);. asser
0fd0: 74 28 20 69 44 62 3e 3d 30 20 29 3b 0a 0a 20 20 t( iDb>=0 );..
0fe0: 70 54 61 62 6c 65 2d 3e 69 73 56 69 72 74 75 61 pTable->isVirtua
0ff0: 6c 20 3d 20 31 3b 0a 20 20 70 54 61 62 6c 65 2d l = 1;. pTable-
1000: 3e 6e 4d 6f 64 75 6c 65 41 72 67 20 3d 20 30 3b >nModuleArg = 0;
1010: 0a 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 . addModuleArgu
1020: 6d 65 6e 74 28 70 54 61 62 6c 65 2c 20 73 71 6c ment(pTable, sql
1030: 69 74 65 33 4e 61 6d 65 46 72 6f 6d 54 6f 6b 65 ite3NameFromToke
1040: 6e 28 70 4d 6f 64 75 6c 65 4e 61 6d 65 29 29 3b n(pModuleName));
1050: 0a 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 . addModuleArgu
1060: 6d 65 6e 74 28 70 54 61 62 6c 65 2c 20 73 71 6c ment(pTable, sql
1070: 69 74 65 33 53 74 72 44 75 70 28 70 50 61 72 73 ite3StrDup(pPars
1080: 65 2d 3e 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e e->db->aDb[iDb].
1090: 7a 4e 61 6d 65 29 29 3b 0a 20 20 61 64 64 4d 6f zName));. addMo
10a0: 64 75 6c 65 41 72 67 75 6d 65 6e 74 28 70 54 61 duleArgument(pTa
10b0: 62 6c 65 2c 20 73 71 6c 69 74 65 33 53 74 72 44 ble, sqlite3StrD
10c0: 75 70 28 70 54 61 62 6c 65 2d 3e 7a 4e 61 6d 65 up(pTable->zName
10d0: 29 29 3b 0a 20 20 70 50 61 72 73 65 2d 3e 73 4e ));. pParse->sN
10e0: 61 6d 65 54 6f 6b 65 6e 2e 6e 20 3d 20 70 4d 6f ameToken.n = pMo
10f0: 64 75 6c 65 4e 61 6d 65 2d 3e 7a 20 2b 20 70 4d duleName->z + pM
1100: 6f 64 75 6c 65 4e 61 6d 65 2d 3e 6e 20 2d 20 70 oduleName->n - p
1110: 4e 61 6d 65 31 2d 3e 7a 3b 0a 0a 23 69 66 6e 64 Name1->z;..#ifnd
1120: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
1130: 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 2f UTHORIZATION. /
1140: 2a 20 43 72 65 61 74 69 6e 67 20 61 20 76 69 72 * Creating a vir
1150: 74 75 61 6c 20 74 61 62 6c 65 20 69 6e 76 6f 6b tual table invok
1160: 65 73 20 74 68 65 20 61 75 74 68 6f 72 69 7a 61 es the authoriza
1170: 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 74 77 tion callback tw
1180: 69 63 65 2e 0a 20 20 2a 2a 20 54 68 65 20 66 69 ice.. ** The fi
1190: 72 73 74 20 69 6e 76 6f 63 61 74 69 6f 6e 2c 20 rst invocation,
11a0: 74 6f 20 6f 62 74 61 69 6e 20 70 65 72 6d 69 73 to obtain permis
11b0: 73 69 6f 6e 20 74 6f 20 49 4e 53 45 52 54 20 61 sion to INSERT a
11c0: 20 72 6f 77 20 69 6e 74 6f 20 74 68 65 0a 20 20 row into the.
11d0: 2a 2a 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 ** sqlite_master
11e0: 20 74 61 62 6c 65 2c 20 68 61 73 20 61 6c 72 65 table, has alre
11f0: 61 64 79 20 62 65 65 6e 20 6d 61 64 65 20 62 79 ady been made by
1200: 20 73 71 6c 69 74 65 33 53 74 61 72 74 54 61 62 sqlite3StartTab
1210: 6c 65 28 29 2e 0a 20 20 2a 2a 20 54 68 65 20 73 le().. ** The s
1220: 65 63 6f 6e 64 20 63 61 6c 6c 2c 20 74 6f 20 6f econd call, to o
1230: 62 74 61 69 6e 20 70 65 72 6d 69 73 73 69 6f 6e btain permission
1240: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 74 to create the t
1250: 61 62 6c 65 2c 20 69 73 20 6d 61 64 65 20 6e 6f able, is made no
1260: 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 54 w.. */. if( pT
1270: 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 able->azModuleAr
1280: 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 g ){. sqlite3
1290: 41 75 74 68 43 68 65 63 6b 28 70 50 61 72 73 65 AuthCheck(pParse
12a0: 2c 20 53 51 4c 49 54 45 5f 43 52 45 41 54 45 5f , SQLITE_CREATE_
12b0: 56 54 41 42 4c 45 2c 20 70 54 61 62 6c 65 2d 3e VTABLE, pTable->
12c0: 7a 4e 61 6d 65 2c 20 0a 20 20 20 20 20 20 20 20 zName, .
12d0: 20 20 20 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f pTable->azMo
12e0: 64 75 6c 65 41 72 67 5b 30 5d 2c 20 70 50 61 72 duleArg[0], pPar
12f0: 73 65 2d 3e 64 62 2d 3e 61 44 62 5b 69 44 62 5d se->db->aDb[iDb]
1300: 2e 7a 4e 61 6d 65 29 3b 0a 20 20 7d 0a 23 65 6e .zName);. }.#en
1310: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 dif.}../*.** Thi
1320: 73 20 72 6f 75 74 69 6e 65 20 74 61 6b 65 73 20 s routine takes
1330: 74 68 65 20 6d 6f 64 75 6c 65 20 61 72 67 75 6d the module argum
1340: 65 6e 74 20 74 68 61 74 20 68 61 73 20 62 65 65 ent that has bee
1350: 6e 20 61 63 63 75 6d 75 6c 61 74 69 6e 67 0a 2a n accumulating.*
1360: 2a 20 69 6e 20 70 50 61 72 73 65 2d 3e 7a 41 72 * in pParse->zAr
1370: 67 5b 5d 20 61 6e 64 20 61 70 70 65 6e 64 73 20 g[] and appends
1380: 69 74 20 74 6f 20 74 68 65 20 6c 69 73 74 20 6f it to the list o
1390: 66 20 61 72 67 75 6d 65 6e 74 73 20 6f 6e 20 74 f arguments on t
13a0: 68 65 0a 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 he.** virtual ta
13b0: 62 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 75 6e ble currently un
13c0: 64 65 72 20 63 6f 6e 73 74 72 75 63 74 69 6f 6e der construction
13d0: 20 69 6e 20 70 50 61 72 73 65 2d 3e 70 54 61 62 in pParse->pTab
13e0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f le..*/.static vo
13f0: 69 64 20 61 64 64 41 72 67 75 6d 65 6e 74 54 6f id addArgumentTo
1400: 56 74 61 62 28 50 61 72 73 65 20 2a 70 50 61 72 Vtab(Parse *pPar
1410: 73 65 29 7b 0a 20 20 69 66 28 20 70 50 61 72 73 se){. if( pPars
1420: 65 2d 3e 73 41 72 67 2e 7a 20 26 26 20 70 50 61 e->sArg.z && pPa
1430: 72 73 65 2d 3e 70 4e 65 77 54 61 62 6c 65 20 29 rse->pNewTable )
1440: 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 {. const char
1450: 20 2a 7a 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 *z = (const cha
1460: 72 2a 29 70 50 61 72 73 65 2d 3e 73 41 72 67 2e r*)pParse->sArg.
1470: 7a 3b 0a 20 20 20 20 69 6e 74 20 6e 20 3d 20 70 z;. int n = p
1480: 50 61 72 73 65 2d 3e 73 41 72 67 2e 6e 3b 0a 20 Parse->sArg.n;.
1490: 20 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 addModuleArgu
14a0: 6d 65 6e 74 28 70 50 61 72 73 65 2d 3e 70 4e 65 ment(pParse->pNe
14b0: 77 54 61 62 6c 65 2c 20 73 71 6c 69 74 65 53 74 wTable, sqliteSt
14c0: 72 4e 44 75 70 28 7a 2c 20 6e 29 29 3b 0a 20 20 rNDup(z, n));.
14d0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 }.}../*.** The p
14e0: 61 72 73 65 72 20 63 61 6c 6c 73 20 74 68 69 73 arser calls this
14f0: 20 72 6f 75 74 69 6e 65 20 61 66 74 65 72 20 74 routine after t
1500: 68 65 20 43 52 45 41 54 45 20 56 49 52 54 55 41 he CREATE VIRTUA
1510: 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e L TABLE statemen
1520: 74 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 63 6f t.** has been co
1530: 6d 70 6c 65 74 65 6c 79 20 70 61 72 73 65 64 2e mpletely parsed.
1540: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
1550: 56 74 61 62 46 69 6e 69 73 68 50 61 72 73 65 28 VtabFinishParse(
1560: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 54 Parse *pParse, T
1570: 6f 6b 65 6e 20 2a 70 45 6e 64 29 7b 0a 20 20 54 oken *pEnd){. T
1580: 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 able *pTab;
1590: 20 20 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 /* The table
15a0: 62 65 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 65 being constructe
15b0: 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a d */. sqlite3 *
15c0: 64 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 db; /* Th
15d0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
15e0: 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 68 61 72 20 ction */. char
15f0: 2a 7a 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 2f *zModule; /
1600: 2a 20 54 68 65 20 6d 6f 64 75 6c 65 20 6e 61 6d * The module nam
1610: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 3a 20 e of the table:
1620: 55 53 49 4e 47 20 6d 6f 64 75 6c 65 6e 61 6d 65 USING modulename
1630: 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d */. Module *pM
1640: 6f 64 20 3d 20 30 3b 0a 0a 20 20 61 64 64 41 72 od = 0;.. addAr
1650: 67 75 6d 65 6e 74 54 6f 56 74 61 62 28 70 50 61 gumentToVtab(pPa
1660: 72 73 65 29 3b 0a 20 20 70 50 61 72 73 65 2d 3e rse);. pParse->
1670: 73 41 72 67 2e 7a 20 3d 20 30 3b 0a 0a 20 20 2f sArg.z = 0;.. /
1680: 2a 20 4c 6f 6f 6b 75 70 20 74 68 65 20 6d 6f 64 * Lookup the mod
1690: 75 6c 65 20 6e 61 6d 65 2e 20 2a 2f 0a 20 20 70 ule name. */. p
16a0: 54 61 62 20 3d 20 70 50 61 72 73 65 2d 3e 70 4e Tab = pParse->pN
16b0: 65 77 54 61 62 6c 65 3b 0a 20 20 69 66 28 20 70 ewTable;. if( p
16c0: 54 61 62 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b Tab==0 ) return;
16d0: 0a 20 20 64 62 20 3d 20 70 50 61 72 73 65 2d 3e . db = pParse->
16e0: 64 62 3b 0a 20 20 69 66 28 20 70 54 61 62 2d 3e db;. if( pTab->
16f0: 6e 4d 6f 64 75 6c 65 41 72 67 3c 31 20 29 20 72 nModuleArg<1 ) r
1700: 65 74 75 72 6e 3b 0a 20 20 7a 4d 6f 64 75 6c 65 eturn;. zModule
1710: 20 3d 20 70 54 61 62 2d 3e 61 7a 4d 6f 64 75 6c = pTab->azModul
1720: 65 41 72 67 5b 30 5d 3b 0a 20 20 70 4d 6f 64 20 eArg[0];. pMod
1730: 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 = (Module *)sqli
1740: 74 65 33 48 61 73 68 46 69 6e 64 28 26 64 62 2d te3HashFind(&db-
1750: 3e 61 4d 6f 64 75 6c 65 2c 20 7a 4d 6f 64 75 6c >aModule, zModul
1760: 65 2c 20 73 74 72 6c 65 6e 28 7a 4d 6f 64 75 6c e, strlen(zModul
1770: 65 29 29 3b 0a 20 20 70 54 61 62 2d 3e 70 4d 6f e));. pTab->pMo
1780: 64 20 3d 20 70 4d 6f 64 3b 0a 20 20 0a 20 20 2f d = pMod;. . /
1790: 2a 20 49 66 20 74 68 65 20 43 52 45 41 54 45 20 * If the CREATE
17a0: 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 VIRTUAL TABLE st
17b0: 61 74 65 6d 65 6e 74 20 69 73 20 62 65 69 6e 67 atement is being
17c0: 20 65 6e 74 65 72 65 64 20 66 6f 72 20 74 68 65 entered for the
17d0: 0a 20 20 2a 2a 20 66 69 72 73 74 20 74 69 6d 65 . ** first time
17e0: 20 28 69 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 (in other words
17f0: 20 69 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 if the virtual
1800: 74 61 62 6c 65 20 69 73 20 61 63 74 75 61 6c 6c table is actuall
1810: 79 20 62 65 69 6e 67 0a 20 20 2a 2a 20 63 72 65 y being. ** cre
1820: 61 74 65 64 20 6e 6f 77 20 69 6e 73 74 65 61 64 ated now instead
1830: 20 6f 66 20 6a 75 73 74 20 62 65 69 6e 67 20 72 of just being r
1840: 65 61 64 20 6f 75 74 20 6f 66 20 73 71 6c 69 74 ead out of sqlit
1850: 65 5f 6d 61 73 74 65 72 29 20 74 68 65 6e 0a 20 e_master) then.
1860: 20 2a 2a 20 64 6f 20 61 64 64 69 74 69 6f 6e 61 ** do additiona
1870: 6c 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e l initialization
1880: 20 77 6f 72 6b 20 61 6e 64 20 73 74 6f 72 65 20 work and store
1890: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 65 the statement te
18a0: 78 74 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 73 xt. ** in the s
18b0: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 qlite_master tab
18c0: 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 le.. */. if( !
18d0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b db->init.busy ){
18e0: 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 74 6d 74 . char *zStmt
18f0: 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 57 68 65 ;. char *zWhe
1900: 72 65 3b 0a 20 20 20 20 69 6e 74 20 69 44 62 3b re;. int iDb;
1910: 0a 20 20 20 20 56 64 62 65 20 2a 76 3b 0a 0a 20 . Vdbe *v;..
1920: 20 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 74 68 /* Compute th
1930: 65 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 e complete text
1940: 6f 66 20 74 68 65 20 43 52 45 41 54 45 20 56 49 of the CREATE VI
1950: 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 61 74 RTUAL TABLE stat
1960: 65 6d 65 6e 74 20 2a 2f 0a 20 20 20 20 69 66 28 ement */. if(
1970: 20 70 45 6e 64 20 29 7b 0a 20 20 20 20 20 20 70 pEnd ){. p
1980: 50 61 72 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b 65 Parse->sNameToke
1990: 6e 2e 6e 20 3d 20 70 45 6e 64 2d 3e 7a 20 2d 20 n.n = pEnd->z -
19a0: 70 50 61 72 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b pParse->sNameTok
19b0: 65 6e 2e 7a 20 2b 20 70 45 6e 64 2d 3e 6e 3b 0a en.z + pEnd->n;.
19c0: 20 20 20 20 7d 0a 20 20 20 20 7a 53 74 6d 74 20 }. zStmt
19d0: 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 = sqlite3MPrintf
19e0: 28 22 43 52 45 41 54 45 20 56 49 52 54 55 41 4c ("CREATE VIRTUAL
19f0: 20 54 41 42 4c 45 20 25 54 22 2c 20 26 70 50 61 TABLE %T", &pPa
1a00: 72 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b 65 6e 29 rse->sNameToken)
1a10: 3b 0a 0a 20 20 20 20 2f 2a 20 41 20 73 6c 6f 74 ;.. /* A slot
1a20: 20 66 6f 72 20 74 68 65 20 72 65 63 6f 72 64 20 for the record
1a30: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
1a40: 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 74 68 allocated in th
1a50: 65 20 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 e . ** SQLITE
1a60: 5f 4d 41 53 54 45 52 20 74 61 62 6c 65 2e 20 20 _MASTER table.
1a70: 57 65 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20 We just need to
1a80: 75 70 64 61 74 65 20 74 68 61 74 20 73 6c 6f 74 update that slot
1a90: 20 77 69 74 68 20 61 6c 6c 0a 20 20 20 20 2a 2a with all. **
1aa0: 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e the information
1ab0: 20 77 65 27 76 65 20 63 6f 6c 6c 65 63 74 65 64 we've collected
1ac0: 2e 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a . . **. *
1ad0: 2a 20 54 68 65 20 74 6f 70 20 6f 66 20 74 68 65 * The top of the
1ae0: 20 73 74 61 63 6b 20 69 73 20 74 68 65 20 72 6f stack is the ro
1af0: 6f 74 70 61 67 65 20 61 6c 6c 6f 63 61 74 65 64 otpage allocated
1b00: 20 62 79 20 73 71 6c 69 74 65 33 53 74 61 72 74 by sqlite3Start
1b10: 54 61 62 6c 65 28 29 2e 0a 20 20 20 20 2a 2a 20 Table().. **
1b20: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 61 6c This value is al
1b30: 77 61 79 73 20 30 20 61 6e 64 20 69 73 20 69 67 ways 0 and is ig
1b40: 6e 6f 72 65 64 2c 20 61 20 76 69 72 74 75 61 6c nored, a virtual
1b50: 20 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f 74 20 table does not
1b60: 68 61 76 65 20 61 0a 20 20 20 20 2a 2a 20 72 6f have a. ** ro
1b70: 6f 74 70 61 67 65 2e 20 54 68 65 20 6e 65 78 74 otpage. The next
1b80: 20 65 6e 74 72 79 20 6f 6e 20 74 68 65 20 73 74 entry on the st
1b90: 61 63 6b 20 69 73 20 74 68 65 20 72 6f 77 69 64 ack is the rowid
1ba0: 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 0a 20 of the record.
1bb0: 20 20 20 2a 2a 20 69 6e 20 74 68 65 20 73 71 6c ** in the sql
1bc0: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 ite_master table
1bd0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 44 62 .. */. iDb
1be0: 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 = sqlite3Schema
1bf0: 54 6f 49 6e 64 65 78 28 64 62 2c 20 70 54 61 62 ToIndex(db, pTab
1c00: 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 ->pSchema);.
1c10: 73 71 6c 69 74 65 33 4e 65 73 74 65 64 50 61 72 sqlite3NestedPar
1c20: 73 65 28 70 50 61 72 73 65 2c 0a 20 20 20 20 20 se(pParse,.
1c30: 20 22 55 50 44 41 54 45 20 25 51 2e 25 73 20 22 "UPDATE %Q.%s "
1c40: 0a 20 20 20 20 20 20 20 20 20 22 53 45 54 20 74 . "SET t
1c50: 79 70 65 3d 27 74 61 62 6c 65 27 2c 20 6e 61 6d ype='table', nam
1c60: 65 3d 25 51 2c 20 74 62 6c 5f 6e 61 6d 65 3d 25 e=%Q, tbl_name=%
1c70: 51 2c 20 72 6f 6f 74 70 61 67 65 3d 30 2c 20 73 Q, rootpage=0, s
1c80: 71 6c 3d 25 51 20 22 0a 20 20 20 20 20 20 20 22 ql=%Q ". "
1c90: 57 48 45 52 45 20 72 6f 77 69 64 3d 23 31 22 2c WHERE rowid=#1",
1ca0: 0a 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 . db->aDb[i
1cb0: 44 62 5d 2e 7a 4e 61 6d 65 2c 20 53 43 48 45 4d Db].zName, SCHEM
1cc0: 41 5f 54 41 42 4c 45 28 69 44 62 29 2c 0a 20 20 A_TABLE(iDb),.
1cd0: 20 20 20 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c pTab->zName,
1ce0: 0a 20 20 20 20 20 20 70 54 61 62 2d 3e 7a 4e 61 . pTab->zNa
1cf0: 6d 65 2c 0a 20 20 20 20 20 20 7a 53 74 6d 74 0a me,. zStmt.
1d00: 20 20 20 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 );. sqlit
1d10: 65 46 72 65 65 28 7a 53 74 6d 74 29 3b 0a 20 20 eFree(zStmt);.
1d20: 20 20 76 20 3d 20 73 71 6c 69 74 65 33 47 65 74 v = sqlite3Get
1d30: 56 64 62 65 28 70 50 61 72 73 65 29 3b 0a 20 20 Vdbe(pParse);.
1d40: 20 20 73 71 6c 69 74 65 33 43 68 61 6e 67 65 43 sqlite3ChangeC
1d50: 6f 6f 6b 69 65 28 64 62 2c 20 76 2c 20 69 44 62 ookie(db, v, iDb
1d60: 29 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 56 );.. sqlite3V
1d70: 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 45 dbeAddOp(v, OP_E
1d80: 78 70 69 72 65 2c 20 30 2c 20 30 29 3b 0a 20 20 xpire, 0, 0);.
1d90: 20 20 7a 57 68 65 72 65 20 3d 20 73 71 6c 69 74 zWhere = sqlit
1da0: 65 33 4d 50 72 69 6e 74 66 28 22 6e 61 6d 65 3d e3MPrintf("name=
1db0: 27 25 71 27 22 2c 20 70 54 61 62 2d 3e 7a 4e 61 '%q'", pTab->zNa
1dc0: 6d 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 me);. sqlite3
1dd0: 56 64 62 65 4f 70 33 28 76 2c 20 4f 50 5f 50 61 VdbeOp3(v, OP_Pa
1de0: 72 73 65 53 63 68 65 6d 61 2c 20 69 44 62 2c 20 rseSchema, iDb,
1df0: 31 2c 20 7a 57 68 65 72 65 2c 20 50 33 5f 44 59 1, zWhere, P3_DY
1e00: 4e 41 4d 49 43 29 3b 0a 20 20 20 20 73 71 6c 69 NAMIC);. sqli
1e10: 74 65 33 56 64 62 65 4f 70 33 28 76 2c 20 4f 50 te3VdbeOp3(v, OP
1e20: 5f 56 43 72 65 61 74 65 2c 20 69 44 62 2c 20 30 _VCreate, iDb, 0
1e30: 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 73 , pTab->zName, s
1e40: 74 72 6c 65 6e 28 70 54 61 62 2d 3e 7a 4e 61 6d trlen(pTab->zNam
1e50: 65 29 20 2b 20 31 29 3b 0a 20 20 7d 0a 0a 20 20 e) + 1);. }..
1e60: 2f 2a 20 49 66 20 77 65 20 61 72 65 20 72 65 72 /* If we are rer
1e70: 65 61 64 69 6e 67 20 74 68 65 20 73 71 6c 69 74 eading the sqlit
1e80: 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20 63 e_master table c
1e90: 72 65 61 74 65 20 74 68 65 20 69 6e 2d 6d 65 6d reate the in-mem
1ea0: 6f 72 79 0a 20 20 2a 2a 20 72 65 63 6f 72 64 20 ory. ** record
1eb0: 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20 49 66 of the table. If
1ec0: 20 74 68 65 20 6d 6f 64 75 6c 65 20 68 61 73 20 the module has
1ed0: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 72 65 67 already been reg
1ee0: 69 73 74 65 72 65 64 2c 0a 20 20 2a 2a 20 61 6c istered,. ** al
1ef0: 73 6f 20 63 61 6c 6c 20 74 68 65 20 78 43 6f 6e so call the xCon
1f00: 6e 65 63 74 20 6d 65 74 68 6f 64 20 68 65 72 65 nect method here
1f10: 2e 0a 20 20 2a 2f 0a 20 20 65 6c 73 65 20 7b 0a .. */. else {.
1f20: 20 20 20 20 54 61 62 6c 65 20 2a 70 4f 6c 64 3b Table *pOld;
1f30: 0a 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 . Schema *pSc
1f40: 68 65 6d 61 20 3d 20 70 54 61 62 2d 3e 70 53 63 hema = pTab->pSc
1f50: 68 65 6d 61 3b 0a 20 20 20 20 63 6f 6e 73 74 20 hema;. const
1f60: 63 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 70 54 char *zName = pT
1f70: 61 62 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20 69 ab->zName;. i
1f80: 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65 nt nName = strle
1f90: 6e 28 7a 4e 61 6d 65 29 20 2b 20 31 3b 0a 20 20 n(zName) + 1;.
1fa0: 20 20 70 4f 6c 64 20 3d 20 73 71 6c 69 74 65 33 pOld = sqlite3
1fb0: 48 61 73 68 49 6e 73 65 72 74 28 26 70 53 63 68 HashInsert(&pSch
1fc0: 65 6d 61 2d 3e 74 62 6c 48 61 73 68 2c 20 7a 4e ema->tblHash, zN
1fd0: 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 70 54 61 62 ame, nName, pTab
1fe0: 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64 20 );. if( pOld
1ff0: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
2000: 20 70 54 61 62 3d 3d 70 4f 6c 64 20 29 3b 20 20 pTab==pOld );
2010: 2f 2a 20 4d 61 6c 6c 6f 63 20 6d 75 73 74 20 68 /* Malloc must h
2020: 61 76 65 20 66 61 69 6c 65 64 20 69 6e 73 69 64 ave failed insid
2030: 65 20 48 61 73 68 49 6e 73 65 72 74 28 29 20 2a e HashInsert() *
2040: 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 3b 0a /. return;.
2050: 20 20 20 20 7d 0a 20 20 20 20 70 50 61 72 73 65 }. pParse
2060: 2d 3e 70 4e 65 77 54 61 62 6c 65 20 3d 20 30 3b ->pNewTable = 0;
2070: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 . }.}../*.** Th
2080: 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73 20 74 e parser calls t
2090: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e his routine when
20a0: 20 69 74 20 73 65 65 73 20 74 68 65 20 66 69 72 it sees the fir
20b0: 73 74 20 74 6f 6b 65 6e 0a 2a 2a 20 6f 66 20 61 st token.** of a
20c0: 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 n argument to th
20d0: 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 69 6e e module name in
20e0: 20 61 20 43 52 45 41 54 45 20 56 49 52 54 55 41 a CREATE VIRTUA
20f0: 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e L TABLE statemen
2100: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 t..*/.void sqlit
2110: 65 33 56 74 61 62 41 72 67 49 6e 69 74 28 50 61 e3VtabArgInit(Pa
2120: 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20 20 rse *pParse){.
2130: 61 64 64 41 72 67 75 6d 65 6e 74 54 6f 56 74 61 addArgumentToVta
2140: 62 28 70 50 61 72 73 65 29 3b 0a 20 20 70 50 61 b(pParse);. pPa
2150: 72 73 65 2d 3e 73 41 72 67 2e 7a 20 3d 20 30 3b rse->sArg.z = 0;
2160: 0a 20 20 70 50 61 72 73 65 2d 3e 73 41 72 67 2e . pParse->sArg.
2170: 6e 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n = 0;.}../*.**
2180: 54 68 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73 The parser calls
2190: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 66 6f this routine fo
21a0: 72 20 65 61 63 68 20 74 6f 6b 65 6e 20 61 66 74 r each token aft
21b0: 65 72 20 74 68 65 20 66 69 72 73 74 20 74 6f 6b er the first tok
21c0: 65 6e 0a 2a 2a 20 69 6e 20 61 6e 20 61 72 67 75 en.** in an argu
21d0: 6d 65 6e 74 20 74 6f 20 74 68 65 20 6d 6f 64 75 ment to the modu
21e0: 6c 65 20 6e 61 6d 65 20 69 6e 20 61 20 43 52 45 le name in a CRE
21f0: 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c ATE VIRTUAL TABL
2200: 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a E statement..*/.
2210: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
2220: 41 72 67 45 78 74 65 6e 64 28 50 61 72 73 65 20 ArgExtend(Parse
2230: 2a 70 50 61 72 73 65 2c 20 54 6f 6b 65 6e 20 2a *pParse, Token *
2240: 70 29 7b 0a 20 20 54 6f 6b 65 6e 20 2a 70 41 72 p){. Token *pAr
2250: 67 20 3d 20 26 70 50 61 72 73 65 2d 3e 73 41 72 g = &pParse->sAr
2260: 67 3b 0a 20 20 69 66 28 20 70 41 72 67 2d 3e 7a g;. if( pArg->z
2270: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 41 72 67 2d ==0 ){. pArg-
2280: 3e 7a 20 3d 20 70 2d 3e 7a 3b 0a 20 20 20 20 70 >z = p->z;. p
2290: 41 72 67 2d 3e 6e 20 3d 20 70 2d 3e 6e 3b 0a 20 Arg->n = p->n;.
22a0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
22b0: 72 74 28 70 41 72 67 2d 3e 7a 20 3c 20 70 2d 3e rt(pArg->z < p->
22c0: 7a 29 3b 0a 20 20 20 20 70 41 72 67 2d 3e 6e 20 z);. pArg->n
22d0: 3d 20 28 70 2d 3e 7a 20 2b 20 70 2d 3e 6e 20 2d = (p->z + p->n -
22e0: 20 70 41 72 67 2d 3e 7a 29 3b 0a 20 20 7d 0a 7d pArg->z);. }.}
22f0: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 61 ../*.** Invoke a
2300: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 virtual table c
2310: 6f 6e 73 74 72 75 63 74 6f 72 20 28 65 69 74 68 onstructor (eith
2320: 65 72 20 78 43 72 65 61 74 65 20 6f 72 20 78 43 er xCreate or xC
2330: 6f 6e 6e 65 63 74 29 2e 20 54 68 65 0a 2a 2a 20 onnect). The.**
2340: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 66 pointer to the f
2350: 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b unction to invok
2360: 65 20 69 73 20 70 61 73 73 65 64 20 61 73 20 74 e is passed as t
2370: 68 65 20 66 6f 75 72 74 68 20 70 61 72 61 6d 65 he fourth parame
2380: 74 65 72 0a 2a 2a 20 74 6f 20 74 68 69 73 20 70 ter.** to this p
2390: 72 6f 63 65 64 75 72 65 2e 0a 2a 2f 0a 73 74 61 rocedure..*/.sta
23a0: 74 69 63 20 69 6e 74 20 76 74 61 62 43 61 6c 6c tic int vtabCall
23b0: 43 6f 6e 73 74 72 75 63 74 6f 72 28 0a 20 20 73 Constructor(. s
23c0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 54 qlite3 *db, . T
23d0: 61 62 6c 65 20 2a 70 54 61 62 2c 0a 20 20 4d 6f able *pTab,. Mo
23e0: 64 75 6c 65 20 2a 70 4d 6f 64 2c 0a 20 20 69 6e dule *pMod,. in
23f0: 74 20 28 2a 78 43 6f 6e 73 74 72 75 63 74 29 28 t (*xConstruct)(
2400: 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 sqlite3*,void*,i
2410: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 63 6f nt,const char*co
2420: 6e 73 74 2a 2c 73 71 6c 69 74 65 33 5f 76 74 61 nst*,sqlite3_vta
2430: 62 2a 2a 2c 63 68 61 72 2a 2a 29 2c 0a 20 20 63 b**,char**),. c
2440: 68 61 72 20 2a 2a 70 7a 45 72 72 0a 29 7b 0a 20 har **pzErr.){.
2450: 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 72 int rc;. int r
2460: 63 32 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 c2;. sqlite3_vt
2470: 61 62 20 2a 70 56 74 61 62 3b 0a 20 20 63 6f 6e ab *pVtab;. con
2480: 73 74 20 63 68 61 72 20 2a 63 6f 6e 73 74 2a 61 st char *const*a
2490: 7a 41 72 67 20 3d 20 28 63 6f 6e 73 74 20 63 68 zArg = (const ch
24a0: 61 72 20 2a 63 6f 6e 73 74 2a 29 70 54 61 62 2d ar *const*)pTab-
24b0: 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20 >azModuleArg;.
24c0: 69 6e 74 20 6e 41 72 67 20 3d 20 70 54 61 62 2d int nArg = pTab-
24d0: 3e 6e 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20 63 >nModuleArg;. c
24e0: 68 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 har *zErr = 0;.
24f0: 20 63 68 61 72 20 2a 7a 4d 6f 64 75 6c 65 4e 61 char *zModuleNa
2500: 6d 65 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 me = sqlite3MPri
2510: 6e 74 66 28 22 25 73 22 2c 20 70 54 61 62 2d 3e ntf("%s", pTab->
2520: 7a 4e 61 6d 65 29 3b 0a 0a 20 20 61 73 73 65 72 zName);.. asser
2530: 74 28 20 21 64 62 2d 3e 70 56 54 61 62 20 29 3b t( !db->pVTab );
2540: 0a 20 20 61 73 73 65 72 74 28 20 78 43 6f 6e 73 . assert( xCons
2550: 74 72 75 63 74 20 29 3b 0a 0a 20 20 64 62 2d 3e truct );.. db->
2560: 70 56 54 61 62 20 3d 20 70 54 61 62 3b 0a 20 20 pVTab = pTab;.
2570: 72 63 20 3d 20 73 71 6c 69 74 65 33 53 61 66 65 rc = sqlite3Safe
2580: 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 61 73 73 tyOff(db);. ass
2590: 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ert( rc==SQLITE_
25a0: 4f 4b 20 29 3b 0a 20 20 72 63 20 3d 20 78 43 6f OK );. rc = xCo
25b0: 6e 73 74 72 75 63 74 28 64 62 2c 20 70 4d 6f 64 nstruct(db, pMod
25c0: 2d 3e 70 41 75 78 2c 20 6e 41 72 67 2c 20 61 7a ->pAux, nArg, az
25d0: 41 72 67 2c 20 26 70 54 61 62 2d 3e 70 56 74 61 Arg, &pTab->pVta
25e0: 62 2c 20 26 7a 45 72 72 29 3b 0a 20 20 72 63 32 b, &zErr);. rc2
25f0: 20 3d 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 = sqlite3Safety
2600: 4f 6e 28 64 62 29 3b 0a 20 20 70 56 74 61 62 20 On(db);. pVtab
2610: 3d 20 70 54 61 62 2d 3e 70 56 74 61 62 3b 0a 20 = pTab->pVtab;.
2620: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2630: 4f 4b 20 26 26 20 70 56 74 61 62 20 29 7b 0a 20 OK && pVtab ){.
2640: 20 20 20 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c pVtab->pModul
2650: 65 20 3d 20 70 4d 6f 64 2d 3e 70 4d 6f 64 75 6c e = pMod->pModul
2660: 65 3b 0a 20 20 20 20 70 56 74 61 62 2d 3e 6e 52 e;. pVtab->nR
2670: 65 66 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 69 ef = 1;. }.. i
2680: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 f( SQLITE_OK!=rc
2690: 20 29 7b 0a 20 20 20 20 69 66 28 20 7a 45 72 72 ){. if( zErr
26a0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2a 70 7a ==0 ){. *pz
26b0: 45 72 72 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 Err = sqlite3MPr
26c0: 69 6e 74 66 28 22 76 74 61 62 6c 65 20 63 6f 6e intf("vtable con
26d0: 73 74 72 75 63 74 6f 72 20 66 61 69 6c 65 64 3a structor failed:
26e0: 20 25 73 22 2c 20 7a 4d 6f 64 75 6c 65 4e 61 6d %s", zModuleNam
26f0: 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 7b 0a e);. }else {.
2700: 20 20 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 *pzErr = s
2710: 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 22 25 qlite3MPrintf("%
2720: 73 22 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20 s", zErr);.
2730: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 sqlite3_free(zE
2740: 72 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c rr);. }. }el
2750: 73 65 20 69 66 28 20 64 62 2d 3e 70 56 54 61 62 se if( db->pVTab
2760: 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 ){. const ch
2770: 61 72 20 2a 7a 46 6f 72 6d 61 74 20 3d 20 22 76 ar *zFormat = "v
2780: 74 61 62 6c 65 20 63 6f 6e 73 74 72 75 63 74 6f table constructo
2790: 72 20 64 69 64 20 6e 6f 74 20 64 65 63 6c 61 72 r did not declar
27a0: 65 20 73 63 68 65 6d 61 3a 20 25 73 22 3b 0a 20 e schema: %s";.
27b0: 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 *pzErr = sqli
27c0: 74 65 33 4d 50 72 69 6e 74 66 28 7a 46 6f 72 6d te3MPrintf(zForm
27d0: 61 74 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 at, pTab->zName)
27e0: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 ;. rc = SQLIT
27f0: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 20 0a 20 20 E_ERROR;. } .
2800: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2810: 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 72 63 K ){. rc = rc
2820: 32 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 70 56 54 2;. }. db->pVT
2830: 61 62 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 ab = 0;. sqlite
2840: 46 72 65 65 28 7a 4d 6f 64 75 6c 65 4e 61 6d 65 Free(zModuleName
2850: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
2860: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
2870: 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 nction is invoke
2880: 64 20 62 79 20 74 68 65 20 70 61 72 73 65 72 20 d by the parser
2890: 74 6f 20 63 61 6c 6c 20 74 68 65 20 78 43 6f 6e to call the xCon
28a0: 6e 65 63 74 28 29 20 6d 65 74 68 6f 64 0a 2a 2a nect() method.**
28b0: 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 of the virtual
28c0: 74 61 62 6c 65 20 70 54 61 62 2e 20 49 66 20 61 table pTab. If a
28d0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 n error occurs,
28e0: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
28f0: 20 72 65 74 75 72 6e 65 64 20 0a 2a 2a 20 61 6e returned .** an
2900: 64 20 61 6e 20 65 72 72 6f 72 20 6c 65 66 74 20 d an error left
2910: 69 6e 20 70 50 61 72 73 65 2e 0a 2a 2a 0a 2a 2a in pParse..**.**
2920: 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20 61 20 This call is a
2930: 6e 6f 2d 6f 70 20 69 66 20 74 61 62 6c 65 20 70 no-op if table p
2940: 54 61 62 20 69 73 20 6e 6f 74 20 61 20 76 69 72 Tab is not a vir
2950: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2f 0a 69 tual table..*/.i
2960: 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 nt sqlite3VtabCa
2970: 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 73 65 20 llConnect(Parse
2980: 2a 70 50 61 72 73 65 2c 20 54 61 62 6c 65 20 2a *pParse, Table *
2990: 70 54 61 62 29 7b 0a 20 20 4d 6f 64 75 6c 65 20 pTab){. Module
29a0: 2a 70 4d 6f 64 3b 0a 20 20 69 6e 74 20 72 63 20 *pMod;. int rc
29b0: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
29c0: 69 66 28 20 21 70 54 61 62 20 7c 7c 20 21 70 54 if( !pTab || !pT
29d0: 61 62 2d 3e 69 73 56 69 72 74 75 61 6c 20 7c 7c ab->isVirtual ||
29e0: 20 70 54 61 62 2d 3e 70 56 74 61 62 20 29 7b 0a pTab->pVtab ){.
29f0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2a00: 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 70 4d 6f E_OK;. }.. pMo
2a10: 64 20 3d 20 70 54 61 62 2d 3e 70 4d 6f 64 3b 0a d = pTab->pMod;.
2a20: 20 20 69 66 28 20 21 70 4d 6f 64 20 29 7b 0a 20 if( !pMod ){.
2a30: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a const char *z
2a40: 4d 6f 64 75 6c 65 20 3d 20 70 54 61 62 2d 3e 61 Module = pTab->a
2a50: 7a 4d 6f 64 75 6c 65 41 72 67 5b 30 5d 3b 0a 20 zModuleArg[0];.
2a60: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 4d sqlite3ErrorM
2a70: 73 67 28 70 50 61 72 73 65 2c 20 22 6e 6f 20 73 sg(pParse, "no s
2a80: 75 63 68 20 6d 6f 64 75 6c 65 3a 20 25 73 22 2c uch module: %s",
2a90: 20 7a 4d 6f 64 75 6c 65 29 3b 0a 20 20 20 20 72 zModule);. r
2aa0: 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
2ab0: 3b 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 ;. } else {.
2ac0: 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b char *zErr = 0;
2ad0: 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 . sqlite3 *db
2ae0: 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 = pParse->db;.
2af0: 20 20 20 72 63 20 3d 20 76 74 61 62 43 61 6c 6c rc = vtabCall
2b00: 43 6f 6e 73 74 72 75 63 74 6f 72 28 64 62 2c 20 Constructor(db,
2b10: 70 54 61 62 2c 20 70 4d 6f 64 2c 20 70 4d 6f 64 pTab, pMod, pMod
2b20: 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 43 6f 6e 6e ->pModule->xConn
2b30: 65 63 74 2c 20 26 7a 45 72 72 29 3b 0a 20 20 20 ect, &zErr);.
2b40: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
2b50: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 OK ){. sqli
2b60: 74 65 33 45 72 72 6f 72 4d 73 67 28 70 50 61 72 te3ErrorMsg(pPar
2b70: 73 65 2c 20 22 25 73 22 2c 20 7a 45 72 72 29 3b se, "%s", zErr);
2b80: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
2b90: 65 46 72 65 65 28 7a 45 72 72 29 3b 0a 20 20 7d eFree(zErr);. }
2ba0: 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
2bb0: 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 74 68 65 20 ../*.** Add the
2bc0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 70 56 virtual table pV
2bd0: 74 61 62 20 74 6f 20 74 68 65 20 61 72 72 61 79 tab to the array
2be0: 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e 73 sqlite3.aVTrans
2bf0: 5b 5d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e []..*/.static in
2c00: 74 20 61 64 64 54 6f 56 54 72 61 6e 73 28 73 71 t addToVTrans(sq
2c10: 6c 69 74 65 33 20 2a 64 62 2c 20 73 71 6c 69 74 lite3 *db, sqlit
2c20: 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 29 7b e3_vtab *pVtab){
2c30: 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 41 52 52 . const int ARR
2c40: 41 59 5f 49 4e 43 52 20 3d 20 35 3b 0a 0a 20 20 AY_INCR = 5;..
2c50: 2f 2a 20 47 72 6f 77 20 74 68 65 20 73 71 6c 69 /* Grow the sqli
2c60: 74 65 33 2e 61 56 54 72 61 6e 73 20 61 72 72 61 te3.aVTrans arra
2c70: 79 20 69 66 20 72 65 71 75 69 72 65 64 20 2a 2f y if required */
2c80: 0a 20 20 69 66 28 20 28 64 62 2d 3e 6e 56 54 72 . if( (db->nVTr
2c90: 61 6e 73 25 41 52 52 41 59 5f 49 4e 43 52 29 3d ans%ARRAY_INCR)=
2ca0: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 =0 ){. sqlite
2cb0: 33 5f 76 74 61 62 20 2a 2a 61 56 54 72 61 6e 73 3_vtab **aVTrans
2cc0: 3b 0a 20 20 20 20 69 6e 74 20 6e 42 79 74 65 73 ;. int nBytes
2cd0: 20 3d 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 = sizeof(sqlite
2ce0: 33 5f 76 74 61 62 20 2a 29 20 2a 20 28 64 62 2d 3_vtab *) * (db-
2cf0: 3e 6e 56 54 72 61 6e 73 20 2b 20 41 52 52 41 59 >nVTrans + ARRAY
2d00: 5f 49 4e 43 52 29 3b 0a 20 20 20 20 61 56 54 72 _INCR);. aVTr
2d10: 61 6e 73 20 3d 20 73 71 6c 69 74 65 52 65 61 6c ans = sqliteReal
2d20: 6c 6f 63 28 28 76 6f 69 64 20 2a 29 64 62 2d 3e loc((void *)db->
2d30: 61 56 54 72 61 6e 73 2c 20 6e 42 79 74 65 73 29 aVTrans, nBytes)
2d40: 3b 0a 20 20 20 20 69 66 28 20 21 61 56 54 72 61 ;. if( !aVTra
2d50: 6e 73 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ns ){. retu
2d60: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
2d70: 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 . }. memse
2d80: 74 28 26 61 56 54 72 61 6e 73 5b 64 62 2d 3e 6e t(&aVTrans[db->n
2d90: 56 54 72 61 6e 73 5d 2c 20 30 2c 20 73 69 7a 65 VTrans], 0, size
2da0: 6f 66 28 73 71 6c 69 74 65 33 5f 76 74 61 62 20 of(sqlite3_vtab
2db0: 2a 29 2a 41 52 52 41 59 5f 49 4e 43 52 29 3b 0a *)*ARRAY_INCR);.
2dc0: 20 20 20 20 64 62 2d 3e 61 56 54 72 61 6e 73 20 db->aVTrans
2dd0: 3d 20 61 56 54 72 61 6e 73 3b 0a 20 20 7d 0a 0a = aVTrans;. }..
2de0: 20 20 2f 2a 20 41 64 64 20 70 56 74 61 62 20 74 /* Add pVtab t
2df0: 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 73 71 6c o the end of sql
2e00: 69 74 65 33 2e 61 56 54 72 61 6e 73 20 2a 2f 0a ite3.aVTrans */.
2e10: 20 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b 64 62 db->aVTrans[db
2e20: 2d 3e 6e 56 54 72 61 6e 73 2b 2b 5d 20 3d 20 70 ->nVTrans++] = p
2e30: 56 74 61 62 3b 0a 20 20 73 71 6c 69 74 65 33 56 Vtab;. sqlite3V
2e40: 74 61 62 4c 6f 63 6b 28 70 56 74 61 62 29 3b 0a tabLock(pVtab);.
2e50: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2e60: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 OK;.}../*.** Thi
2e70: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e s function is in
2e80: 76 6f 6b 65 64 20 62 79 20 74 68 65 20 76 64 62 voked by the vdb
2e90: 65 20 74 6f 20 63 61 6c 6c 20 74 68 65 20 78 43 e to call the xC
2ea0: 72 65 61 74 65 20 6d 65 74 68 6f 64 0a 2a 2a 20 reate method.**
2eb0: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 of the virtual t
2ec0: 61 62 6c 65 20 6e 61 6d 65 64 20 7a 54 61 62 20 able named zTab
2ed0: 69 6e 20 64 61 74 61 62 61 73 65 20 69 44 62 2e in database iDb.
2ee0: 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 .**.** If an er
2ef0: 72 6f 72 20 6f 63 63 75 72 73 2c 20 2a 70 7a 45 ror occurs, *pzE
2f00: 72 72 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 rr is set to poi
2f10: 6e 74 20 61 6e 20 61 6e 20 45 6e 67 6c 69 73 68 nt an an English
2f20: 20 6c 61 6e 67 75 61 67 65 0a 2a 2a 20 64 65 73 language.** des
2f30: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 cription of the
2f40: 65 72 72 6f 72 20 61 6e 64 20 61 6e 20 53 51 4c error and an SQL
2f50: 49 54 45 5f 58 58 58 20 65 72 72 6f 72 20 63 6f ITE_XXX error co
2f60: 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a de is returned..
2f70: 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 ** In this case
2f80: 74 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 the caller must
2f90: 63 61 6c 6c 20 73 71 6c 69 74 65 46 72 65 65 28 call sqliteFree(
2fa0: 29 20 6f 6e 20 2a 70 7a 45 72 72 2e 0a 2a 2f 0a ) on *pzErr..*/.
2fb0: 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
2fc0: 61 6c 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 allCreate(sqlite
2fd0: 33 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 3 *db, int iDb,
2fe0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 const char *zTab
2ff0: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 29 7b , char **pzErr){
3000: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
3010: 54 45 5f 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a TE_OK;. Table *
3020: 70 54 61 62 3b 0a 20 20 4d 6f 64 75 6c 65 20 2a pTab;. Module *
3030: 70 4d 6f 64 3b 0a 20 20 63 6f 6e 73 74 20 63 68 pMod;. const ch
3040: 61 72 20 2a 7a 4d 6f 64 75 6c 65 3b 0a 0a 20 20 ar *zModule;..
3050: 70 54 61 62 20 3d 20 73 71 6c 69 74 65 33 46 69 pTab = sqlite3Fi
3060: 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 54 61 62 ndTable(db, zTab
3070: 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a , db->aDb[iDb].z
3080: 4e 61 6d 65 29 3b 0a 20 20 61 73 73 65 72 74 28 Name);. assert(
3090: 70 54 61 62 20 26 26 20 70 54 61 62 2d 3e 69 73 pTab && pTab->is
30a0: 56 69 72 74 75 61 6c 20 26 26 20 21 70 54 61 62 Virtual && !pTab
30b0: 2d 3e 70 56 74 61 62 29 3b 0a 20 20 70 4d 6f 64 ->pVtab);. pMod
30c0: 20 3d 20 70 54 61 62 2d 3e 70 4d 6f 64 3b 0a 20 = pTab->pMod;.
30d0: 20 7a 4d 6f 64 75 6c 65 20 3d 20 70 54 61 62 2d zModule = pTab-
30e0: 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 30 5d 3b >azModuleArg[0];
30f0: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 6d 6f .. /* If the mo
3100: 64 75 6c 65 20 68 61 73 20 62 65 65 6e 20 72 65 dule has been re
3110: 67 69 73 74 65 72 65 64 20 61 6e 64 20 69 6e 63 gistered and inc
3120: 6c 75 64 65 73 20 61 20 43 72 65 61 74 65 20 6d ludes a Create m
3130: 65 74 68 6f 64 2c 20 0a 20 20 2a 2a 20 69 6e 76 ethod, . ** inv
3140: 6f 6b 65 20 69 74 20 6e 6f 77 2e 20 49 66 20 74 oke it now. If t
3150: 68 65 20 6d 6f 64 75 6c 65 20 68 61 73 20 6e 6f he module has no
3160: 74 20 62 65 65 6e 20 72 65 67 69 73 74 65 72 65 t been registere
3170: 64 2c 20 72 65 74 75 72 6e 20 61 6e 20 0a 20 20 d, return an .
3180: 2a 2a 20 65 72 72 6f 72 2e 20 4f 74 68 65 72 77 ** error. Otherw
3190: 69 73 65 2c 20 64 6f 20 6e 6f 74 68 69 6e 67 2e ise, do nothing.
31a0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 4d 6f . */. if( !pMo
31b0: 64 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 72 20 d ){. *pzErr
31c0: 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 = sqlite3MPrintf
31d0: 28 22 6e 6f 20 73 75 63 68 20 6d 6f 64 75 6c 65 ("no such module
31e0: 3a 20 25 73 22 2c 20 7a 4d 6f 64 75 6c 65 29 3b : %s", zModule);
31f0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
3200: 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73 65 7b _ERROR;. }else{
3210: 0a 20 20 20 20 72 63 20 3d 20 76 74 61 62 43 61 . rc = vtabCa
3220: 6c 6c 43 6f 6e 73 74 72 75 63 74 6f 72 28 64 62 llConstructor(db
3230: 2c 20 70 54 61 62 2c 20 70 4d 6f 64 2c 20 70 4d , pTab, pMod, pM
3240: 6f 64 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 43 72 od->pModule->xCr
3250: 65 61 74 65 2c 20 70 7a 45 72 72 29 3b 0a 20 20 eate, pzErr);.
3260: 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }.. if( rc==SQL
3270: 49 54 45 5f 4f 4b 20 26 26 20 70 54 61 62 2d 3e ITE_OK && pTab->
3280: 70 56 74 61 62 20 29 7b 0a 20 20 20 20 20 20 72 pVtab ){. r
3290: 63 20 3d 20 61 64 64 54 6f 56 54 72 61 6e 73 28 c = addToVTrans(
32a0: 64 62 2c 20 70 54 61 62 2d 3e 70 56 74 61 62 29 db, pTab->pVtab)
32b0: 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
32c0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 rc;.}../*.** Thi
32d0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 s function is us
32e0: 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 73 63 ed to set the sc
32f0: 68 65 6d 61 20 6f 66 20 61 20 76 69 72 74 75 61 hema of a virtua
3300: 6c 20 74 61 62 6c 65 2e 20 20 49 74 20 69 73 20 l table. It is
3310: 6f 6e 6c 79 0a 2a 2a 20 76 61 6c 69 64 20 74 6f only.** valid to
3320: 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 call this funct
3330: 69 6f 6e 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 ion from within
3340: 74 68 65 20 78 43 72 65 61 74 65 28 29 20 6f 72 the xCreate() or
3350: 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f 66 20 61 xConnect() of a
3360: 0a 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 62 6c .** virtual tabl
3370: 65 20 6d 6f 64 75 6c 65 2e 0a 2a 2f 0a 69 6e 74 e module..*/.int
3380: 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 sqlite3_declare
3390: 5f 76 74 61 62 28 73 71 6c 69 74 65 33 20 2a 64 _vtab(sqlite3 *d
33a0: 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a b, const char *z
33b0: 43 72 65 61 74 65 54 61 62 6c 65 29 7b 0a 20 20 CreateTable){.
33c0: 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a 0a 20 Parse sParse;..
33d0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
33e0: 5f 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 _OK;. Table *pT
33f0: 61 62 20 3d 20 64 62 2d 3e 70 56 54 61 62 3b 0a ab = db->pVTab;.
3400: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30 char *zErr = 0
3410: 3b 0a 0a 20 20 69 66 28 20 21 70 54 61 62 20 29 ;.. if( !pTab )
3420: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 {. sqlite3Err
3430: 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 or(db, SQLITE_MI
3440: 53 55 53 45 2c 20 30 29 3b 0a 20 20 20 20 72 65 SUSE, 0);. re
3450: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
3460: 53 45 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 SE;. }. assert
3470: 28 70 54 61 62 2d 3e 69 73 56 69 72 74 75 61 6c (pTab->isVirtual
3480: 20 26 26 20 70 54 61 62 2d 3e 6e 43 6f 6c 3d 3d && pTab->nCol==
3490: 30 20 26 26 20 70 54 61 62 2d 3e 61 43 6f 6c 3d 0 && pTab->aCol=
34a0: 3d 30 29 3b 0a 0a 20 20 6d 65 6d 73 65 74 28 26 =0);.. memset(&
34b0: 73 50 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f sParse, 0, sizeo
34c0: 66 28 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 f(Parse));. sPa
34d0: 72 73 65 2e 64 65 63 6c 61 72 65 56 74 61 62 20 rse.declareVtab
34e0: 3d 20 31 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 = 1;. sParse.db
34f0: 20 3d 20 64 62 3b 0a 0a 20 20 69 66 28 20 0a 20 = db;.. if( .
3500: 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b 20 3d SQLITE_OK =
3510: 3d 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 73 = sqlite3RunPars
3520: 65 72 28 26 73 50 61 72 73 65 2c 20 7a 43 72 65 er(&sParse, zCre
3530: 61 74 65 54 61 62 6c 65 2c 20 26 7a 45 72 72 29 ateTable, &zErr)
3540: 20 26 26 20 0a 20 20 20 20 20 20 73 50 61 72 73 && . sPars
3550: 65 2e 70 4e 65 77 54 61 62 6c 65 20 26 26 20 0a e.pNewTable && .
3560: 20 20 20 20 20 20 21 73 50 61 72 73 65 2e 70 4e !sParse.pN
3570: 65 77 54 61 62 6c 65 2d 3e 70 53 65 6c 65 63 74 ewTable->pSelect
3580: 20 26 26 20 0a 20 20 20 20 20 20 21 73 50 61 72 && . !sPar
3590: 73 65 2e 70 4e 65 77 54 61 62 6c 65 2d 3e 69 73 se.pNewTable->is
35a0: 56 69 72 74 75 61 6c 20 0a 20 20 29 7b 0a 20 20 Virtual . ){.
35b0: 20 20 70 54 61 62 2d 3e 61 43 6f 6c 20 3d 20 73 pTab->aCol = s
35c0: 50 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65 2d Parse.pNewTable-
35d0: 3e 61 43 6f 6c 3b 0a 20 20 20 20 70 54 61 62 2d >aCol;. pTab-
35e0: 3e 6e 43 6f 6c 20 3d 20 73 50 61 72 73 65 2e 70 >nCol = sParse.p
35f0: 4e 65 77 54 61 62 6c 65 2d 3e 6e 43 6f 6c 3b 0a NewTable->nCol;.
3600: 20 20 20 20 73 50 61 72 73 65 2e 70 4e 65 77 54 sParse.pNewT
3610: 61 62 6c 65 2d 3e 6e 43 6f 6c 20 3d 20 30 3b 0a able->nCol = 0;.
3620: 20 20 20 20 73 50 61 72 73 65 2e 70 4e 65 77 54 sParse.pNewT
3630: 61 62 6c 65 2d 3e 61 43 6f 6c 20 3d 20 30 3b 0a able->aCol = 0;.
3640: 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 } else {. s
3650: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
3660: 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20 7a 45 SQLITE_ERROR, zE
3670: 72 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 rr);. sqliteF
3680: 72 65 65 28 7a 45 72 72 29 3b 0a 20 20 20 20 72 ree(zErr);. r
3690: 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
36a0: 3b 0a 20 20 7d 0a 20 20 73 50 61 72 73 65 2e 64 ;. }. sParse.d
36b0: 65 63 6c 61 72 65 56 74 61 62 20 3d 20 30 3b 0a eclareVtab = 0;.
36c0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c . sqlite3_final
36d0: 69 7a 65 28 28 73 71 6c 69 74 65 33 5f 73 74 6d ize((sqlite3_stm
36e0: 74 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 29 t*)sParse.pVdbe)
36f0: 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 6c 65 74 ;. sqlite3Delet
3700: 65 54 61 62 6c 65 28 30 2c 20 73 50 61 72 73 65 eTable(0, sParse
3710: 2e 70 4e 65 77 54 61 62 6c 65 29 3b 0a 20 20 73 .pNewTable);. s
3720: 50 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65 20 Parse.pNewTable
3730: 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 56 54 61 62 = 0;. db->pVTab
3740: 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 = 0;.. assert(
3750: 20 28 72 63 26 30 78 66 66 29 3d 3d 72 63 20 29 (rc&0xff)==rc )
3760: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
3770: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
3780: 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64 ction is invoked
3790: 20 62 79 20 74 68 65 20 76 64 62 65 20 74 6f 20 by the vdbe to
37a0: 63 61 6c 6c 20 74 68 65 20 78 44 65 73 74 72 6f call the xDestro
37b0: 79 20 6d 65 74 68 6f 64 0a 2a 2a 20 6f 66 20 74 y method.** of t
37c0: 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 he virtual table
37d0: 20 6e 61 6d 65 64 20 7a 54 61 62 20 69 6e 20 64 named zTab in d
37e0: 61 74 61 62 61 73 65 20 69 44 62 2e 20 54 68 69 atabase iDb. Thi
37f0: 73 20 6f 63 63 75 72 73 0a 2a 2a 20 77 68 65 6e s occurs.** when
3800: 20 61 20 44 52 4f 50 20 54 41 42 4c 45 20 69 73 a DROP TABLE is
3810: 20 6d 65 6e 74 69 6f 6e 65 64 2e 0a 2a 2a 0a 2a mentioned..**.*
3820: 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20 61 * This call is a
3830: 20 6e 6f 2d 6f 70 20 69 66 20 7a 54 61 62 20 69 no-op if zTab i
3840: 73 20 6e 6f 74 20 61 20 76 69 72 74 75 61 6c 20 s not a virtual
3850: 74 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 table..*/.int sq
3860: 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 44 65 73 lite3VtabCallDes
3870: 74 72 6f 79 28 73 71 6c 69 74 65 33 20 2a 64 62 troy(sqlite3 *db
3880: 2c 20 69 6e 74 20 69 44 62 2c 20 63 6f 6e 73 74 , int iDb, const
3890: 20 63 68 61 72 20 2a 7a 54 61 62 29 0a 7b 0a 20 char *zTab).{.
38a0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
38b0: 5f 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 _OK;. Table *pT
38c0: 61 62 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73 71 ab;.. pTab = sq
38d0: 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 64 lite3FindTable(d
38e0: 62 2c 20 7a 54 61 62 2c 20 64 62 2d 3e 61 44 62 b, zTab, db->aDb
38f0: 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 [iDb].zName);.
3900: 61 73 73 65 72 74 28 70 54 61 62 29 3b 0a 20 20 assert(pTab);.
3910: 69 66 28 20 70 54 61 62 2d 3e 70 56 74 61 62 20 if( pTab->pVtab
3920: 29 7b 0a 20 20 20 20 69 6e 74 20 28 2a 78 44 65 ){. int (*xDe
3930: 73 74 72 6f 79 29 28 73 71 6c 69 74 65 33 5f 76 stroy)(sqlite3_v
3940: 74 61 62 20 2a 70 56 54 61 62 29 20 3d 20 70 54 tab *pVTab) = pT
3950: 61 62 2d 3e 70 4d 6f 64 2d 3e 70 4d 6f 64 75 6c ab->pMod->pModul
3960: 65 2d 3e 78 44 65 73 74 72 6f 79 3b 0a 20 20 20 e->xDestroy;.
3970: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 53 61 66 rc = sqlite3Saf
3980: 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 etyOff(db);.
3990: 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
39a0: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 69 66 28 TE_OK );. if(
39b0: 20 78 44 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 xDestroy ){.
39c0: 20 20 20 72 63 20 3d 20 78 44 65 73 74 72 6f 79 rc = xDestroy
39d0: 28 70 54 61 62 2d 3e 70 56 74 61 62 29 3b 0a 20 (pTab->pVtab);.
39e0: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
39f0: 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 SafetyOn(db);.
3a00: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
3a10: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 54 61 _OK ){. pTa
3a20: 62 2d 3e 70 56 74 61 62 20 3d 20 30 3b 0a 20 20 b->pVtab = 0;.
3a30: 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 }. }.. retur
3a40: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
3a50: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 6e 76 his function inv
3a60: 6f 6b 65 73 20 65 69 74 68 65 72 20 74 68 65 20 okes either the
3a70: 78 52 6f 6c 6c 62 61 63 6b 20 6f 72 20 78 43 6f xRollback or xCo
3a80: 6d 6d 69 74 20 6d 65 74 68 6f 64 0a 2a 2a 20 6f mmit method.** o
3a90: 66 20 65 61 63 68 20 6f 66 20 74 68 65 20 76 69 f each of the vi
3aa0: 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 20 rtual tables in
3ab0: 74 68 65 20 73 71 6c 69 74 65 33 2e 61 56 54 72 the sqlite3.aVTr
3ac0: 61 6e 73 20 61 72 72 61 79 2e 20 54 68 65 20 6d ans array. The m
3ad0: 65 74 68 6f 64 0a 2a 2a 20 63 61 6c 6c 65 64 20 ethod.** called
3ae0: 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 is identified by
3af0: 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 the second argu
3b00: 6d 65 6e 74 2c 20 22 6f 66 66 73 65 74 22 2c 20 ment, "offset",
3b10: 77 68 69 63 68 20 69 73 0a 2a 2a 20 74 68 65 20 which is.** the
3b20: 6f 66 66 73 65 74 20 6f 66 20 74 68 65 20 6d 65 offset of the me
3b30: 74 68 6f 64 20 74 6f 20 63 61 6c 6c 20 69 6e 20 thod to call in
3b40: 74 68 65 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 the sqlite3_modu
3b50: 6c 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a le structure..**
3b60: 0a 2a 2a 20 54 68 65 20 61 72 72 61 79 20 69 73 .** The array is
3b70: 20 63 6c 65 61 72 65 64 20 61 66 74 65 72 20 69 cleared after i
3b80: 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 61 6c 6c nvoking the call
3b90: 62 61 63 6b 73 2e 20 0a 2a 2f 0a 73 74 61 74 69 backs. .*/.stati
3ba0: 63 20 76 6f 69 64 20 63 61 6c 6c 46 69 6e 61 6c c void callFinal
3bb0: 69 73 65 72 28 73 71 6c 69 74 65 33 20 2a 64 62 iser(sqlite3 *db
3bc0: 2c 20 69 6e 74 20 6f 66 66 73 65 74 29 7b 0a 20 , int offset){.
3bd0: 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d int i;. for(i=
3be0: 30 3b 20 69 3c 64 62 2d 3e 6e 56 54 72 61 6e 73 0; i<db->nVTrans
3bf0: 20 26 26 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b && db->aVTrans[
3c00: 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 i]; i++){. sq
3c10: 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 lite3_vtab *pVta
3c20: 62 20 3d 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b b = db->aVTrans[
3c30: 69 5d 3b 0a 20 20 20 20 69 6e 74 20 28 2a 78 29 i];. int (*x)
3c40: 28 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 29 (sqlite3_vtab *)
3c50: 3b 0a 20 20 20 20 78 20 3d 20 2a 28 69 6e 74 20 ;. x = *(int
3c60: 28 2a 2a 29 28 73 71 6c 69 74 65 33 5f 76 74 61 (**)(sqlite3_vta
3c70: 62 20 2a 29 29 28 28 63 68 61 72 20 2a 29 70 56 b *))((char *)pV
3c80: 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 20 2b 20 6f tab->pModule + o
3c90: 66 66 73 65 74 29 3b 0a 20 20 20 20 69 66 28 20 ffset);. if(
3ca0: 78 20 29 20 78 28 70 56 74 61 62 29 3b 0a 20 20 x ) x(pVtab);.
3cb0: 20 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c sqlite3VtabUnl
3cc0: 6f 63 6b 28 70 56 74 61 62 29 3b 0a 20 20 7d 0a ock(pVtab);. }.
3cd0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 2d sqliteFree(db-
3ce0: 3e 61 56 54 72 61 6e 73 29 3b 0a 20 20 64 62 2d >aVTrans);. db-
3cf0: 3e 6e 56 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 >nVTrans = 0;.
3d00: 64 62 2d 3e 61 56 54 72 61 6e 73 20 3d 20 30 3b db->aVTrans = 0;
3d10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 61 72 67 .}../*.** If arg
3d20: 75 6d 65 6e 74 20 72 63 32 20 69 73 20 6e 6f 74 ument rc2 is not
3d30: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 74 68 65 6e SQLITE_OK, then
3d40: 20 72 65 74 75 72 6e 20 69 74 20 61 6e 64 20 64 return it and d
3d50: 6f 20 6e 6f 74 68 69 6e 67 2e 20 0a 2a 2a 20 4f o nothing. .** O
3d60: 74 68 65 72 77 69 73 65 2c 20 69 6e 76 6f 6b 65 therwise, invoke
3d70: 20 74 68 65 20 78 53 79 6e 63 20 6d 65 74 68 6f the xSync metho
3d80: 64 20 6f 66 20 61 6c 6c 20 76 69 72 74 75 61 6c d of all virtual
3d90: 20 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20 0a tables in the .
3da0: 2a 2a 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 ** sqlite3.aVTra
3db0: 6e 73 20 61 72 72 61 79 2e 20 52 65 74 75 72 6e ns array. Return
3dc0: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 the error code
3dd0: 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 65 72 for the first er
3de0: 72 6f 72 20 0a 2a 2a 20 74 68 61 74 20 6f 63 63 ror .** that occ
3df0: 75 72 73 2c 20 6f 72 20 53 51 4c 49 54 45 5f 4f urs, or SQLITE_O
3e00: 4b 20 69 66 20 61 6c 6c 20 78 53 79 6e 63 20 6f K if all xSync o
3e10: 70 65 72 61 74 69 6f 6e 73 20 61 72 65 20 73 75 perations are su
3e20: 63 63 65 73 73 66 75 6c 2e 0a 2a 2f 0a 69 6e 74 ccessful..*/.int
3e30: 20 73 71 6c 69 74 65 33 56 74 61 62 53 79 6e 63 sqlite3VtabSync
3e40: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e (sqlite3 *db, in
3e50: 74 20 72 63 32 29 7b 0a 20 20 69 6e 74 20 69 3b t rc2){. int i;
3e60: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
3e70: 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 72 63 73 TE_OK;. int rcs
3e80: 61 66 65 74 79 3b 0a 20 20 73 71 6c 69 74 65 33 afety;. sqlite3
3e90: 5f 76 74 61 62 20 2a 2a 61 56 54 72 61 6e 73 20 _vtab **aVTrans
3ea0: 3d 20 64 62 2d 3e 61 56 54 72 61 6e 73 3b 0a 20 = db->aVTrans;.
3eb0: 20 69 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 if( rc2!=SQLITE
3ec0: 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 32 _OK ) return rc2
3ed0: 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 ;.. rc = sqlite
3ee0: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 3SafetyOff(db);.
3ef0: 20 20 64 62 2d 3e 61 56 54 72 61 6e 73 20 3d 20 db->aVTrans =
3f00: 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 0;. for(i=0; rc
3f10: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 ==SQLITE_OK && i
3f20: 3c 64 62 2d 3e 6e 56 54 72 61 6e 73 20 26 26 20 <db->nVTrans &&
3f30: 61 56 54 72 61 6e 73 5b 69 5d 3b 20 69 2b 2b 29 aVTrans[i]; i++)
3f40: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 76 74 {. sqlite3_vt
3f50: 61 62 20 2a 70 56 74 61 62 20 3d 20 61 56 54 72 ab *pVtab = aVTr
3f60: 61 6e 73 5b 69 5d 3b 0a 20 20 20 20 69 6e 74 20 ans[i];. int
3f70: 28 2a 78 29 28 73 71 6c 69 74 65 33 5f 76 74 61 (*x)(sqlite3_vta
3f80: 62 20 2a 29 3b 0a 20 20 20 20 78 20 3d 20 70 56 b *);. x = pV
3f90: 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 53 tab->pModule->xS
3fa0: 79 6e 63 3b 0a 20 20 20 20 69 66 28 20 78 20 29 ync;. if( x )
3fb0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 78 28 70 {. rc = x(p
3fc0: 56 74 61 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d Vtab);. }. }
3fd0: 0a 20 20 64 62 2d 3e 61 56 54 72 61 6e 73 20 3d . db->aVTrans =
3fe0: 20 61 56 54 72 61 6e 73 3b 0a 20 20 72 63 73 61 aVTrans;. rcsa
3ff0: 66 65 74 79 20 3d 20 73 71 6c 69 74 65 33 53 61 fety = sqlite3Sa
4000: 66 65 74 79 4f 6e 28 64 62 29 3b 0a 0a 20 20 69 fetyOn(db);.. i
4010: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
4020: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 72 63 73 ){. rc = rcs
4030: 61 66 65 74 79 3b 0a 20 20 7d 0a 20 20 72 65 74 afety;. }. ret
4040: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
4050: 20 49 6e 76 6f 6b 65 20 74 68 65 20 78 52 6f 6c Invoke the xRol
4060: 6c 62 61 63 6b 20 6d 65 74 68 6f 64 20 6f 66 20 lback method of
4070: 61 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62 6c all virtual tabl
4080: 65 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20 73 71 es in the .** sq
4090: 6c 69 74 65 33 2e 61 56 54 72 61 6e 73 20 61 72 lite3.aVTrans ar
40a0: 72 61 79 2e 20 54 68 65 6e 20 63 6c 65 61 72 20 ray. Then clear
40b0: 74 68 65 20 61 72 72 61 79 20 69 74 73 65 6c 66 the array itself
40c0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
40d0: 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 73 71 6c VtabRollback(sql
40e0: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 63 61 6c ite3 *db){. cal
40f0: 6c 46 69 6e 61 6c 69 73 65 72 28 64 62 2c 20 28 lFinaliser(db, (
4100: 69 6e 74 29 28 26 28 28 73 71 6c 69 74 65 33 5f int)(&((sqlite3_
4110: 6d 6f 64 75 6c 65 20 2a 29 30 29 2d 3e 78 52 6f module *)0)->xRo
4120: 6c 6c 62 61 63 6b 29 29 3b 0a 20 20 72 65 74 75 llback));. retu
4130: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
4140: 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 ./*.** Invoke th
4150: 65 20 78 43 6f 6d 6d 69 74 20 6d 65 74 68 6f 64 e xCommit method
4160: 20 6f 66 20 61 6c 6c 20 76 69 72 74 75 61 6c 20 of all virtual
4170: 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20 0a 2a tables in the .*
4180: 2a 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e * sqlite3.aVTran
4190: 73 20 61 72 72 61 79 2e 20 54 68 65 6e 20 63 6c s array. Then cl
41a0: 65 61 72 20 74 68 65 20 61 72 72 61 79 20 69 74 ear the array it
41b0: 73 65 6c 66 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c self..*/.int sql
41c0: 69 74 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 73 ite3VtabCommit(s
41d0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 63 qlite3 *db){. c
41e0: 61 6c 6c 46 69 6e 61 6c 69 73 65 72 28 64 62 2c allFinaliser(db,
41f0: 20 28 69 6e 74 29 28 26 28 28 73 71 6c 69 74 65 (int)(&((sqlite
4200: 33 5f 6d 6f 64 75 6c 65 20 2a 29 30 29 2d 3e 78 3_module *)0)->x
4210: 43 6f 6d 6d 69 74 29 29 3b 0a 20 20 72 65 74 75 Commit));. retu
4220: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
4230: 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 76 69 ./*.** If the vi
4240: 72 74 75 61 6c 20 74 61 62 6c 65 20 70 56 74 61 rtual table pVta
4250: 62 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 74 b supports the t
4260: 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 65 72 ransaction inter
4270: 66 61 63 65 0a 2a 2a 20 28 78 42 65 67 69 6e 2f face.** (xBegin/
4280: 78 52 6f 6c 6c 62 61 63 6b 2f 78 43 6f 6d 6d 69 xRollback/xCommi
4290: 74 20 61 6e 64 20 6f 70 74 69 6f 6e 61 6c 6c 79 t and optionally
42a0: 20 78 53 79 6e 63 29 20 61 6e 64 20 61 20 74 72 xSync) and a tr
42b0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 ansaction is.**
42c0: 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 70 not currently op
42d0: 65 6e 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 78 en, invoke the x
42e0: 42 65 67 69 6e 20 6d 65 74 68 6f 64 20 6e 6f 77 Begin method now
42f0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 78 ..**.** If the x
4300: 42 65 67 69 6e 20 63 61 6c 6c 20 69 73 20 73 75 Begin call is su
4310: 63 63 65 73 73 66 75 6c 2c 20 70 6c 61 63 65 20 ccessful, place
4320: 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 the sqlite3_vtab
4330: 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 69 6e 20 74 pointer.** in t
4340: 68 65 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 he sqlite3.aVTra
4350: 6e 73 20 61 72 72 61 79 2e 0a 2a 2f 0a 69 6e 74 ns array..*/.int
4360: 20 73 71 6c 69 74 65 33 56 74 61 62 42 65 67 69 sqlite3VtabBegi
4370: 6e 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 73 n(sqlite3 *db, s
4380: 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 qlite3_vtab *pVt
4390: 61 62 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ab){. int rc =
43a0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 6f 6e SQLITE_OK;. con
43b0: 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c st sqlite3_modul
43c0: 65 20 2a 70 4d 6f 64 75 6c 65 3b 0a 0a 20 20 2f e *pModule;.. /
43d0: 2a 20 53 70 65 63 69 61 6c 20 63 61 73 65 3a 20 * Special case:
43e0: 49 66 20 64 62 2d 3e 61 56 54 72 61 6e 73 20 69 If db->aVTrans i
43f0: 73 20 4e 55 4c 4c 20 61 6e 64 20 64 62 2d 3e 6e s NULL and db->n
4400: 56 54 72 61 6e 73 20 69 73 20 67 72 65 61 74 65 VTrans is greate
4410: 72 0a 20 20 2a 2a 20 74 68 61 6e 20 7a 65 72 6f r. ** than zero
4420: 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 , then this func
4430: 74 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 63 61 tion is being ca
4440: 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e lled from within
4450: 20 61 0a 20 20 2a 2a 20 76 69 72 74 75 61 6c 20 a. ** virtual
4460: 6d 6f 64 75 6c 65 20 78 53 79 6e 63 28 29 20 63 module xSync() c
4470: 61 6c 6c 62 61 63 6b 2e 20 49 74 20 69 73 20 69 allback. It is i
4480: 6c 6c 65 67 61 6c 20 74 6f 20 77 72 69 74 65 20 llegal to write
4490: 74 6f 20 0a 20 20 2a 2a 20 76 69 72 74 75 61 6c to . ** virtual
44a0: 20 6d 6f 64 75 6c 65 20 74 61 62 6c 65 73 20 69 module tables i
44b0: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 73 6f 20 n this case, so
44c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f return SQLITE_LO
44d0: 43 4b 45 44 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 CKED.. */. if(
44e0: 20 30 3d 3d 64 62 2d 3e 61 56 54 72 61 6e 73 20 0==db->aVTrans
44f0: 26 26 20 64 62 2d 3e 6e 56 54 72 61 6e 73 3e 30 && db->nVTrans>0
4500: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
4510: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 3b 0a 20 20 QLITE_LOCKED;.
4520: 7d 0a 20 20 69 66 28 20 21 70 56 74 61 62 20 29 }. if( !pVtab )
4530: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
4540: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 20 0a 20 20 70 ITE_OK;. } . p
4550: 4d 6f 64 75 6c 65 20 3d 20 70 56 74 61 62 2d 3e Module = pVtab->
4560: 70 4d 6f 64 75 6c 65 3b 0a 0a 20 20 69 66 28 20 pModule;.. if(
4570: 70 4d 6f 64 75 6c 65 2d 3e 78 42 65 67 69 6e 20 pModule->xBegin
4580: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 0a 0a ){. int i;...
4590: 20 20 20 20 2f 2a 20 49 66 20 70 56 74 61 62 20 /* If pVtab
45a0: 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 is already in th
45b0: 65 20 61 56 54 72 61 6e 73 20 61 72 72 61 79 2c e aVTrans array,
45c0: 20 72 65 74 75 72 6e 20 65 61 72 6c 79 20 2a 2f return early */
45d0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 28 69 . for(i=0; (i
45e0: 3c 64 62 2d 3e 6e 56 54 72 61 6e 73 29 20 26 26 <db->nVTrans) &&
45f0: 20 30 21 3d 64 62 2d 3e 61 56 54 72 61 6e 73 5b 0!=db->aVTrans[
4600: 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 i]; i++){.
4610: 69 66 28 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b if( db->aVTrans[
4620: 69 5d 3d 3d 70 56 74 61 62 20 29 7b 0a 20 20 20 i]==pVtab ){.
4630: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
4640: 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 TE_OK;. }.
4650: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 6e 76 }.. /* Inv
4660: 6f 6b 65 20 74 68 65 20 78 42 65 67 69 6e 20 6d oke the xBegin m
4670: 65 74 68 6f 64 20 2a 2f 0a 20 20 20 20 72 63 20 ethod */. rc
4680: 3d 20 70 4d 6f 64 75 6c 65 2d 3e 78 42 65 67 69 = pModule->xBegi
4690: 6e 28 70 56 74 61 62 29 3b 0a 20 20 20 20 69 66 n(pVtab);. if
46a0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
46b0: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
46c0: 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 72 rc;. }.. r
46d0: 63 20 3d 20 61 64 64 54 6f 56 54 72 61 6e 73 28 c = addToVTrans(
46e0: 64 62 2c 20 70 56 74 61 62 29 3b 0a 20 20 7d 0a db, pVtab);. }.
46f0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
4700: 2f 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 /*.** The first
4710: 70 61 72 61 6d 65 74 65 72 20 28 70 44 65 66 29 parameter (pDef)
4720: 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 is a function i
4730: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 mplementation.
4740: 54 68 65 0a 2a 2a 20 73 65 63 6f 6e 64 20 70 61 The.** second pa
4750: 72 61 6d 65 74 65 72 20 28 70 45 78 70 72 29 20 rameter (pExpr)
4760: 69 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 is the first arg
4770: 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 ument to this fu
4780: 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 49 66 20 70 45 nction..** If pE
4790: 78 70 72 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 xpr is a column
47a0: 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 in a virtual tab
47b0: 6c 65 2c 20 74 68 65 6e 20 6c 65 74 20 74 68 65 le, then let the
47c0: 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c virtual.** tabl
47d0: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e e implementation
47e0: 20 68 61 76 65 20 61 6e 20 6f 70 70 6f 72 74 75 have an opportu
47f0: 6e 69 74 79 20 74 6f 20 6f 76 65 72 6c 6f 61 64 nity to overload
4800: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a the function..*
4810: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
4820: 65 20 69 73 20 75 73 65 64 20 74 6f 20 61 6c 6c e is used to all
4830: 6f 77 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ow virtual table
4840: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
4850: 20 74 6f 0a 2a 2a 20 6f 76 65 72 6c 6f 61 64 20 to.** overload
4860: 4d 41 54 43 48 2c 20 4c 49 4b 45 2c 20 47 4c 4f MATCH, LIKE, GLO
4870: 42 2c 20 61 6e 64 20 52 45 47 45 58 50 20 6f 70 B, and REGEXP op
4880: 65 72 61 74 6f 72 73 2e 0a 2a 2a 0a 2a 2a 20 52 erators..**.** R
4890: 65 74 75 72 6e 20 65 69 74 68 65 72 20 74 68 65 eturn either the
48a0: 20 70 44 65 66 20 61 72 67 75 6d 65 6e 74 20 28 pDef argument (
48b0: 69 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 63 68 indicating no ch
48c0: 61 6e 67 65 29 20 6f 72 20 61 20 0a 2a 2a 20 6e ange) or a .** n
48d0: 65 77 20 46 75 6e 63 44 65 66 20 73 74 72 75 63 ew FuncDef struc
48e0: 74 75 72 65 20 74 68 61 74 20 69 73 20 6d 61 72 ture that is mar
48f0: 6b 65 64 20 61 73 20 65 70 68 65 6d 65 72 61 6c ked as ephemeral
4900: 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 53 51 using the.** SQ
4910: 4c 49 54 45 5f 46 55 4e 43 5f 45 50 48 45 4d 20 LITE_FUNC_EPHEM
4920: 66 6c 61 67 2e 0a 2a 2f 0a 46 75 6e 63 44 65 66 flag..*/.FuncDef
4930: 20 2a 73 71 6c 69 74 65 33 56 74 61 62 4f 76 65 *sqlite3VtabOve
4940: 72 6c 6f 61 64 46 75 6e 63 74 69 6f 6e 28 0a 20 rloadFunction(.
4950: 20 46 75 6e 63 44 65 66 20 2a 70 44 65 66 2c 20 FuncDef *pDef,
4960: 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 /* Function to
4970: 70 6f 73 73 69 62 6c 79 20 6f 76 65 72 6c 6f 61 possibly overloa
4980: 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c d */. int nArg,
4990: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
49a0: 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f of arguments to
49b0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f the function */
49c0: 0a 20 20 45 78 70 72 20 2a 70 45 78 70 72 20 20 . Expr *pExpr
49d0: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 /* First argu
49e0: 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 ment to the func
49f0: 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 54 61 62 tion */.){. Tab
4a00: 6c 65 20 2a 70 54 61 62 3b 0a 20 20 73 71 6c 69 le *pTab;. sqli
4a10: 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 3b te3_vtab *pVtab;
4a20: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c . sqlite3_modul
4a30: 65 20 2a 70 4d 6f 64 3b 0a 20 20 76 6f 69 64 20 e *pMod;. void
4a40: 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 (*xFunc)(sqlite3
4a50: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
4a60: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a lite3_value**);.
4a70: 20 20 76 6f 69 64 20 2a 70 41 72 67 3b 0a 20 20 void *pArg;.
4a80: 46 75 6e 63 44 65 66 20 2a 70 4e 65 77 3b 0a 20 FuncDef *pNew;.
4a90: 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 int rc;. char
4aa0: 2a 7a 4c 6f 77 65 72 4e 61 6d 65 3b 0a 20 20 75 *zLowerName;. u
4ab0: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 7a 3b nsigned char *z;
4ac0: 0a 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f ... /* Check to
4ad0: 20 73 65 65 20 74 68 65 20 6c 65 66 74 20 6f 70 see the left op
4ae0: 65 72 61 6e 64 20 69 73 20 61 20 63 6f 6c 75 6d erand is a colum
4af0: 6e 20 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 n in a virtual t
4b00: 61 62 6c 65 20 2a 2f 0a 20 20 69 66 28 20 70 45 able */. if( pE
4b10: 78 70 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 xpr==0 ) return
4b20: 70 44 65 66 3b 0a 20 20 69 66 28 20 70 45 78 70 pDef;. if( pExp
4b30: 72 2d 3e 6f 70 21 3d 54 4b 5f 43 4f 4c 55 4d 4e r->op!=TK_COLUMN
4b40: 20 29 20 72 65 74 75 72 6e 20 70 44 65 66 3b 0a ) return pDef;.
4b50: 20 20 70 54 61 62 20 3d 20 70 45 78 70 72 2d 3e pTab = pExpr->
4b60: 70 54 61 62 3b 0a 20 20 69 66 28 20 70 54 61 62 pTab;. if( pTab
4b70: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 70 44 65 ==0 ) return pDe
4b80: 66 3b 0a 20 20 69 66 28 20 21 70 54 61 62 2d 3e f;. if( !pTab->
4b90: 69 73 56 69 72 74 75 61 6c 20 29 20 72 65 74 75 isVirtual ) retu
4ba0: 72 6e 20 70 44 65 66 3b 0a 20 20 70 56 74 61 62 rn pDef;. pVtab
4bb0: 20 3d 20 70 54 61 62 2d 3e 70 56 74 61 62 3b 0a = pTab->pVtab;.
4bc0: 20 20 61 73 73 65 72 74 28 20 70 56 74 61 62 21 assert( pVtab!
4bd0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
4be0: 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 21 3d pVtab->pModule!=
4bf0: 30 20 29 3b 0a 20 20 70 4d 6f 64 20 3d 20 28 73 0 );. pMod = (s
4c00: 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 29 qlite3_module *)
4c10: 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 3b 0a pVtab->pModule;.
4c20: 20 20 69 66 28 20 70 4d 6f 64 2d 3e 78 46 69 6e if( pMod->xFin
4c30: 64 46 75 6e 63 74 69 6f 6e 3d 3d 30 20 29 20 72 dFunction==0 ) r
4c40: 65 74 75 72 6e 20 70 44 65 66 3b 0a 20 0a 20 20 eturn pDef;. .
4c50: 2f 2a 20 43 61 6c 6c 20 74 68 65 20 78 46 75 6e /* Call the xFun
4c60: 63 46 75 6e 63 74 69 6f 6e 20 6d 65 74 68 6f 64 cFunction method
4c70: 20 6f 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 on the virtual
4c80: 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 table implementa
4c90: 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 73 65 65 tion. ** to see
4ca0: 20 69 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e if the implemen
4cb0: 74 61 74 69 6f 6e 20 77 61 6e 74 73 20 74 6f 20 tation wants to
4cc0: 6f 76 65 72 6c 6f 61 64 20 74 68 69 73 20 66 75 overload this fu
4cd0: 6e 63 74 69 6f 6e 20 0a 20 20 2a 2f 0a 20 20 7a nction . */. z
4ce0: 4c 6f 77 65 72 4e 61 6d 65 20 3d 20 73 71 6c 69 LowerName = sqli
4cf0: 74 65 33 53 74 72 44 75 70 28 70 44 65 66 2d 3e te3StrDup(pDef->
4d00: 7a 4e 61 6d 65 29 3b 0a 20 20 66 6f 72 28 7a 3d zName);. for(z=
4d10: 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 29 (unsigned char*)
4d20: 7a 4c 6f 77 65 72 4e 61 6d 65 3b 20 2a 7a 3b 20 zLowerName; *z;
4d30: 7a 2b 2b 29 7b 0a 20 20 20 20 2a 7a 20 3d 20 73 z++){. *z = s
4d40: 71 6c 69 74 65 33 55 70 70 65 72 54 6f 4c 6f 77 qlite3UpperToLow
4d50: 65 72 5b 2a 7a 5d 3b 0a 20 20 7d 0a 20 20 72 63 er[*z];. }. rc
4d60: 20 3d 20 70 4d 6f 64 2d 3e 78 46 69 6e 64 46 75 = pMod->xFindFu
4d70: 6e 63 74 69 6f 6e 28 70 56 74 61 62 2c 20 6e 41 nction(pVtab, nA
4d80: 72 67 2c 20 7a 4c 6f 77 65 72 4e 61 6d 65 2c 20 rg, zLowerName,
4d90: 26 78 46 75 6e 63 2c 20 26 70 41 72 67 29 3b 0a &xFunc, &pArg);.
4da0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4c 6f sqliteFree(zLo
4db0: 77 65 72 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 werName);. if(
4dc0: 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 rc==0 ){. ret
4dd0: 75 72 6e 20 70 44 65 66 3b 0a 20 20 7d 0a 0a 20 urn pDef;. }..
4de0: 20 2f 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 /* Create a new
4df0: 20 65 70 68 65 6d 65 72 61 6c 20 66 75 6e 63 74 ephemeral funct
4e00: 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 ion definition f
4e10: 6f 72 20 74 68 65 20 6f 76 65 72 6c 6f 61 64 65 or the overloade
4e20: 64 0a 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 d. ** function
4e30: 2a 2f 0a 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 */. pNew = sqli
4e40: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 teMalloc( sizeof
4e50: 28 2a 70 4e 65 77 29 20 2b 20 73 74 72 6c 65 6e (*pNew) + strlen
4e60: 28 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 20 29 3b (pDef->zName) );
4e70: 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 29 . if( pNew==0 )
4e80: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 44 65 {. return pDe
4e90: 66 3b 0a 20 20 7d 0a 20 20 2a 70 4e 65 77 20 3d f;. }. *pNew =
4ea0: 20 2a 70 44 65 66 3b 0a 20 20 73 74 72 63 70 79 *pDef;. strcpy
4eb0: 28 70 4e 65 77 2d 3e 7a 4e 61 6d 65 2c 20 70 44 (pNew->zName, pD
4ec0: 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 70 4e ef->zName);. pN
4ed0: 65 77 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75 6e ew->xFunc = xFun
4ee0: 63 3b 0a 20 20 70 4e 65 77 2d 3e 70 55 73 65 72 c;. pNew->pUser
4ef0: 44 61 74 61 20 3d 20 70 41 72 67 3b 0a 20 20 70 Data = pArg;. p
4f00: 4e 65 77 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 New->flags |= SQ
4f10: 4c 49 54 45 5f 46 55 4e 43 5f 45 50 48 45 4d 3b LITE_FUNC_EPHEM;
4f20: 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 77 3b 0a . return pNew;.
4f30: 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c }..#endif /* SQL
4f40: 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
4f50: 54 41 42 4c 45 20 2a 2f 0a TABLE */.