/ Hex Artifact Content
Login

Artifact 7fbda947e28cbe7adb3ba752a76ca9ef29936750:


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 */.