/ Hex Artifact Content
Login

Artifact ce9d19ca9053812a557010fd4be7e842f8ebba2d:


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 36 39 20 32 30 30  tab.c,v 1.69 200
01d0: 38 2f 30 35 2f 30 35 20 31 33 3a 32 33 3a 30 34  8/05/05 13:23:04
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 73 74 61 74 69 63 20 69 6e  nt.h"..static in
0230: 74 20 63 72 65 61 74 65 4d 6f 64 75 6c 65 28 0a  t createModule(.
0240: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
0250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0260: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 69 6e    /* Database in
0270: 20 77 68 69 63 68 20 6d 6f 64 75 6c 65 20 69 73   which module is
0280: 20 72 65 67 69 73 74 65 72 65 64 20 2a 2f 0a 20   registered */. 
0290: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
02a0: 6d 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  me,             
02b0: 20 2f 2a 20 4e 61 6d 65 20 61 73 73 69 67 6e 65   /* Name assigne
02c0: 64 20 74 6f 20 74 68 69 73 20 6d 6f 64 75 6c 65  d to this module
02d0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69   */.  const sqli
02e0: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64  te3_module *pMod
02f0: 75 6c 65 2c 20 20 2f 2a 20 54 68 65 20 64 65 66  ule,  /* The def
0300: 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  inition of the m
0310: 6f 64 75 6c 65 20 2a 2f 0a 20 20 76 6f 69 64 20  odule */.  void 
0320: 2a 70 41 75 78 2c 20 20 20 20 20 20 20 20 20 20  *pAux,          
0330: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
0340: 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 20 66 6f  ntext pointer fo
0350: 72 20 78 43 72 65 61 74 65 2f 78 43 6f 6e 6e 65  r xCreate/xConne
0360: 63 74 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78  ct */.  void (*x
0370: 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a 29  Destroy)(void *)
0380: 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 64 75 6c          /* Modul
0390: 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e  e destructor fun
03a0: 63 74 69 6f 6e 20 2a 2f 0a 29 20 7b 0a 20 20 69  ction */.) {.  i
03b0: 6e 74 20 72 63 2c 20 6e 4e 61 6d 65 3b 0a 20 20  nt rc, nName;.  
03c0: 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 3b 0a 0a 20  Module *pMod;.. 
03d0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
03e0: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b  nter(db->mutex);
03f0: 0a 20 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c 65  .  nName = strle
0400: 6e 28 7a 4e 61 6d 65 29 3b 0a 20 20 70 4d 6f 64  n(zName);.  pMod
0410: 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c   = (Module *)sql
0420: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28  ite3DbMallocRaw(
0430: 64 62 2c 20 73 69 7a 65 6f 66 28 4d 6f 64 75 6c  db, sizeof(Modul
0440: 65 29 20 2b 20 6e 4e 61 6d 65 20 2b 20 31 29 3b  e) + nName + 1);
0450: 0a 20 20 69 66 28 20 70 4d 6f 64 20 29 7b 0a 20  .  if( pMod ){. 
0460: 20 20 20 63 68 61 72 20 2a 7a 43 6f 70 79 20 3d     char *zCopy =
0470: 20 28 63 68 61 72 20 2a 29 28 26 70 4d 6f 64 5b   (char *)(&pMod[
0480: 31 5d 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28  1]);.    memcpy(
0490: 7a 43 6f 70 79 2c 20 7a 4e 61 6d 65 2c 20 6e 4e  zCopy, zName, nN
04a0: 61 6d 65 2b 31 29 3b 0a 20 20 20 20 70 4d 6f 64  ame+1);.    pMod
04b0: 2d 3e 7a 4e 61 6d 65 20 3d 20 7a 43 6f 70 79 3b  ->zName = zCopy;
04c0: 0a 20 20 20 20 70 4d 6f 64 2d 3e 70 4d 6f 64 75  .    pMod->pModu
04d0: 6c 65 20 3d 20 70 4d 6f 64 75 6c 65 3b 0a 20 20  le = pModule;.  
04e0: 20 20 70 4d 6f 64 2d 3e 70 41 75 78 20 3d 20 70    pMod->pAux = p
04f0: 41 75 78 3b 0a 20 20 20 20 70 4d 6f 64 2d 3e 78  Aux;.    pMod->x
0500: 44 65 73 74 72 6f 79 20 3d 20 78 44 65 73 74 72  Destroy = xDestr
0510: 6f 79 3b 0a 20 20 20 20 70 4d 6f 64 20 3d 20 28  oy;.    pMod = (
0520: 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 33  Module *)sqlite3
0530: 48 61 73 68 49 6e 73 65 72 74 28 26 64 62 2d 3e  HashInsert(&db->
0540: 61 4d 6f 64 75 6c 65 2c 20 7a 43 6f 70 79 2c 20  aModule, zCopy, 
0550: 6e 4e 61 6d 65 2c 20 28 76 6f 69 64 2a 29 70 4d  nName, (void*)pM
0560: 6f 64 29 3b 0a 20 20 20 20 69 66 28 20 70 4d 6f  od);.    if( pMo
0570: 64 20 26 26 20 70 4d 6f 64 2d 3e 78 44 65 73 74  d && pMod->xDest
0580: 72 6f 79 20 29 7b 0a 20 20 20 20 20 20 70 4d 6f  roy ){.      pMo
0590: 64 2d 3e 78 44 65 73 74 72 6f 79 28 70 4d 6f 64  d->xDestroy(pMod
05a0: 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20 7d 0a 20  ->pAux);.    }. 
05b0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
05c0: 70 4d 6f 64 29 3b 0a 20 20 20 20 73 71 6c 69 74  pMod);.    sqlit
05d0: 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  e3ResetInternalS
05e0: 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20  chema(db, 0);.  
05f0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  }.  rc = sqlite3
0600: 41 70 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49  ApiExit(db, SQLI
0610: 54 45 5f 4f 4b 29 3b 0a 20 20 73 71 6c 69 74 65  TE_OK);.  sqlite
0620: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62  3_mutex_leave(db
0630: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75  ->mutex);.  retu
0640: 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  rn rc;.}.../*.**
0650: 20 45 78 74 65 72 6e 61 6c 20 41 50 49 20 66 75   External API fu
0660: 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 63  nction used to c
0670: 72 65 61 74 65 20 61 20 6e 65 77 20 76 69 72 74  reate a new virt
0680: 75 61 6c 2d 74 61 62 6c 65 20 6d 6f 64 75 6c 65  ual-table module
0690: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
06a0: 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 0a  _create_module(.
06b0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
06c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
06d0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 69 6e    /* Database in
06e0: 20 77 68 69 63 68 20 6d 6f 64 75 6c 65 20 69 73   which module is
06f0: 20 72 65 67 69 73 74 65 72 65 64 20 2a 2f 0a 20   registered */. 
0700: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
0710: 6d 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  me,             
0720: 20 2f 2a 20 4e 61 6d 65 20 61 73 73 69 67 6e 65   /* Name assigne
0730: 64 20 74 6f 20 74 68 69 73 20 6d 6f 64 75 6c 65  d to this module
0740: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69   */.  const sqli
0750: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64  te3_module *pMod
0760: 75 6c 65 2c 20 20 2f 2a 20 54 68 65 20 64 65 66  ule,  /* The def
0770: 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  inition of the m
0780: 6f 64 75 6c 65 20 2a 2f 0a 20 20 76 6f 69 64 20  odule */.  void 
0790: 2a 70 41 75 78 20 20 20 20 20 20 20 20 20 20 20  *pAux           
07a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
07b0: 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 20 66 6f  ntext pointer fo
07c0: 72 20 78 43 72 65 61 74 65 2f 78 43 6f 6e 6e 65  r xCreate/xConne
07d0: 63 74 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 75 72  ct */.){.  retur
07e0: 6e 20 63 72 65 61 74 65 4d 6f 64 75 6c 65 28 64  n createModule(d
07f0: 62 2c 20 7a 4e 61 6d 65 2c 20 70 4d 6f 64 75 6c  b, zName, pModul
0800: 65 2c 20 70 41 75 78 2c 20 30 29 3b 0a 7d 0a 0a  e, pAux, 0);.}..
0810: 2f 2a 0a 2a 2a 20 45 78 74 65 72 6e 61 6c 20 41  /*.** External A
0820: 50 49 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64  PI function used
0830: 20 74 6f 20 63 72 65 61 74 65 20 61 20 6e 65 77   to create a new
0840: 20 76 69 72 74 75 61 6c 2d 74 61 62 6c 65 20 6d   virtual-table m
0850: 6f 64 75 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71  odule..*/.int sq
0860: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64  lite3_create_mod
0870: 75 6c 65 5f 76 32 28 0a 20 20 73 71 6c 69 74 65  ule_v2(.  sqlite
0880: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
0890: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
08a0: 61 62 61 73 65 20 69 6e 20 77 68 69 63 68 20 6d  abase in which m
08b0: 6f 64 75 6c 65 20 69 73 20 72 65 67 69 73 74 65  odule is registe
08c0: 72 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  red */.  const c
08d0: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 20 20  har *zName,     
08e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65           /* Name
08f0: 20 61 73 73 69 67 6e 65 64 20 74 6f 20 74 68 69   assigned to thi
0900: 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a 20 20 63 6f  s module */.  co
0910: 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75  nst sqlite3_modu
0920: 6c 65 20 2a 70 4d 6f 64 75 6c 65 2c 20 20 2f 2a  le *pModule,  /*
0930: 20 54 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20   The definition 
0940: 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f  of the module */
0950: 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20 20  .  void *pAux,  
0960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0970: 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 70 6f     /* Context po
0980: 69 6e 74 65 72 20 66 6f 72 20 78 43 72 65 61 74  inter for xCreat
0990: 65 2f 78 43 6f 6e 6e 65 63 74 20 2a 2f 0a 20 20  e/xConnect */.  
09a0: 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29  void (*xDestroy)
09b0: 28 76 6f 69 64 20 2a 29 20 20 20 20 20 20 20 20  (void *)        
09c0: 2f 2a 20 4d 6f 64 75 6c 65 20 64 65 73 74 72 75  /* Module destru
09d0: 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f  ctor function */
09e0: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 72 65  .){.  return cre
09f0: 61 74 65 4d 6f 64 75 6c 65 28 64 62 2c 20 7a 4e  ateModule(db, zN
0a00: 61 6d 65 2c 20 70 4d 6f 64 75 6c 65 2c 20 70 41  ame, pModule, pA
0a10: 75 78 2c 20 78 44 65 73 74 72 6f 79 29 3b 0a 7d  ux, xDestroy);.}
0a20: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65  ../*.** Lock the
0a30: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 73   virtual table s
0a40: 6f 20 74 68 61 74 20 69 74 20 63 61 6e 6e 6f 74  o that it cannot
0a50: 20 62 65 20 64 69 73 63 6f 6e 6e 65 63 74 65 64   be disconnected
0a60: 2e 0a 2a 2a 20 4c 6f 63 6b 73 20 6e 65 73 74 2e  ..** Locks nest.
0a70: 20 20 45 76 65 72 79 20 6c 6f 63 6b 20 73 68 6f    Every lock sho
0a80: 75 6c 64 20 68 61 76 65 20 61 20 63 6f 72 72 65  uld have a corre
0a90: 73 70 6f 6e 64 69 6e 67 20 75 6e 6c 6f 63 6b 2e  sponding unlock.
0aa0: 0a 2a 2a 20 49 66 20 61 6e 20 75 6e 6c 6f 63 6b  .** If an unlock
0ab0: 20 69 73 20 6f 6d 69 74 74 65 64 2c 20 72 65 73   is omitted, res
0ac0: 6f 75 72 63 65 73 20 6c 65 61 6b 73 20 77 69 6c  ources leaks wil
0ad0: 6c 20 6f 63 63 75 72 2e 20 20 0a 2a 2a 0a 2a 2a  l occur.  .**.**
0ae0: 20 49 66 20 61 20 64 69 73 63 6f 6e 6e 65 63 74   If a disconnect
0af0: 20 69 73 20 61 74 74 65 6d 70 74 65 64 20 77 68   is attempted wh
0b00: 69 6c 65 20 61 20 76 69 72 74 75 61 6c 20 74 61  ile a virtual ta
0b10: 62 6c 65 20 69 73 20 6c 6f 63 6b 65 64 2c 0a 2a  ble is locked,.*
0b20: 2a 20 74 68 65 20 64 69 73 63 6f 6e 6e 65 63 74  * the disconnect
0b30: 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e 74   is deferred unt
0b40: 69 6c 20 61 6c 6c 20 6c 6f 63 6b 73 20 68 61 76  il all locks hav
0b50: 65 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 2e 0a  e been removed..
0b60: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
0b70: 74 61 62 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f  tabLock(sqlite3_
0b80: 76 74 61 62 20 2a 70 56 74 61 62 29 7b 0a 20 20  vtab *pVtab){.  
0b90: 70 56 74 61 62 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d  pVtab->nRef++;.}
0ba0: 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b 20 61  ../*.** Unlock a
0bb0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20   virtual table. 
0bc0: 20 57 68 65 6e 20 74 68 65 20 6c 61 73 74 20 6c   When the last l
0bd0: 6f 63 6b 20 69 73 20 72 65 6d 6f 76 65 64 2c 0a  ock is removed,.
0be0: 2a 2a 20 64 69 73 63 6f 6e 6e 65 63 74 20 74 68  ** disconnect th
0bf0: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e  e virtual table.
0c00: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
0c10: 56 74 61 62 55 6e 6c 6f 63 6b 28 73 71 6c 69 74  VtabUnlock(sqlit
0c20: 65 33 20 2a 64 62 2c 20 73 71 6c 69 74 65 33 5f  e3 *db, sqlite3_
0c30: 76 74 61 62 20 2a 70 56 74 61 62 29 7b 0a 20 20  vtab *pVtab){.  
0c40: 70 56 74 61 62 2d 3e 6e 52 65 66 2d 2d 3b 0a 20  pVtab->nRef--;. 
0c50: 20 61 73 73 65 72 74 28 64 62 29 3b 0a 20 20 61   assert(db);.  a
0c60: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 53 61  ssert( sqlite3Sa
0c70: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20  fetyCheckOk(db) 
0c80: 29 3b 0a 20 20 69 66 28 20 70 56 74 61 62 2d 3e  );.  if( pVtab->
0c90: 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 69  nRef==0 ){.    i
0ca0: 66 28 20 64 62 2d 3e 6d 61 67 69 63 3d 3d 53 51  f( db->magic==SQ
0cb0: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 20  LITE_MAGIC_BUSY 
0cc0: 29 7b 0a 20 20 20 20 20 20 28 76 6f 69 64 29 73  ){.      (void)s
0cd0: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
0ce0: 64 62 29 3b 0a 20 20 20 20 20 20 70 56 74 61 62  db);.      pVtab
0cf0: 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 44 69 73 63  ->pModule->xDisc
0d00: 6f 6e 6e 65 63 74 28 70 56 74 61 62 29 3b 0a 20  onnect(pVtab);. 
0d10: 20 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74       (void)sqlit
0d20: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a  e3SafetyOn(db);.
0d30: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20      } else {.   
0d40: 20 20 20 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c     pVtab->pModul
0d50: 65 2d 3e 78 44 69 73 63 6f 6e 6e 65 63 74 28 70  e->xDisconnect(p
0d60: 56 74 61 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Vtab);.    }.  }
0d70: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20  .}../*.** Clear 
0d80: 61 6e 79 20 61 6e 64 20 61 6c 6c 20 76 69 72 74  any and all virt
0d90: 75 61 6c 2d 74 61 62 6c 65 20 69 6e 66 6f 72 6d  ual-table inform
0da0: 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 54  ation from the T
0db0: 61 62 6c 65 20 72 65 63 6f 72 64 2e 0a 2a 2a 20  able record..** 
0dc0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
0dd0: 63 61 6c 6c 65 64 2c 20 66 6f 72 20 65 78 61 6d  called, for exam
0de0: 70 6c 65 2c 20 6a 75 73 74 20 62 65 66 6f 72 65  ple, just before
0df0: 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 54 61   deleting the Ta
0e00: 62 6c 65 0a 2a 2a 20 72 65 63 6f 72 64 2e 0a 2a  ble.** record..*
0e10: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74  /.void sqlite3Vt
0e20: 61 62 43 6c 65 61 72 28 54 61 62 6c 65 20 2a 70  abClear(Table *p
0e30: 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61  ){.  sqlite3_vta
0e40: 62 20 2a 70 56 74 61 62 20 3d 20 70 2d 3e 70 56  b *pVtab = p->pV
0e50: 74 61 62 3b 0a 20 20 69 66 28 20 70 56 74 61 62  tab;.  if( pVtab
0e60: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20   ){.    assert( 
0e70: 70 2d 3e 70 4d 6f 64 20 26 26 20 70 2d 3e 70 4d  p->pMod && p->pM
0e80: 6f 64 2d 3e 70 4d 6f 64 75 6c 65 20 29 3b 0a 20  od->pModule );. 
0e90: 20 20 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e     sqlite3VtabUn
0ea0: 6c 6f 63 6b 28 70 2d 3e 70 53 63 68 65 6d 61 2d  lock(p->pSchema-
0eb0: 3e 64 62 2c 20 70 56 74 61 62 29 3b 0a 20 20 20  >db, pVtab);.   
0ec0: 20 70 2d 3e 70 56 74 61 62 20 3d 20 30 3b 0a 20   p->pVtab = 0;. 
0ed0: 20 7d 0a 20 20 69 66 28 20 70 2d 3e 61 7a 4d 6f   }.  if( p->azMo
0ee0: 64 75 6c 65 41 72 67 20 29 7b 0a 20 20 20 20 69  duleArg ){.    i
0ef0: 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d  nt i;.    for(i=
0f00: 30 3b 20 69 3c 70 2d 3e 6e 4d 6f 64 75 6c 65 41  0; i<p->nModuleA
0f10: 72 67 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  rg; i++){.      
0f20: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e  sqlite3_free(p->
0f30: 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 69 5d 29 3b  azModuleArg[i]);
0f40: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
0f50: 65 33 5f 66 72 65 65 28 70 2d 3e 61 7a 4d 6f 64  e3_free(p->azMod
0f60: 75 6c 65 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a  uleArg);.  }.}..
0f70: 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6e 65 77 20  /*.** Add a new 
0f80: 6d 6f 64 75 6c 65 20 61 72 67 75 6d 65 6e 74 20  module argument 
0f90: 74 6f 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64  to pTable->azMod
0fa0: 75 6c 65 41 72 67 5b 5d 2e 0a 2a 2a 20 54 68 65  uleArg[]..** The
0fb0: 20 73 74 72 69 6e 67 20 69 73 20 6e 6f 74 20 63   string is not c
0fc0: 6f 70 69 65 64 20 2d 20 74 68 65 20 70 6f 69 6e  opied - the poin
0fd0: 74 65 72 20 69 73 20 73 74 6f 72 65 64 2e 20 20  ter is stored.  
0fe0: 54 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 77 69  The.** string wi
0ff0: 6c 6c 20 62 65 20 66 72 65 65 64 20 61 75 74 6f  ll be freed auto
1000: 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 6e 20 74  matically when t
1010: 68 65 20 74 61 62 6c 65 20 69 73 0a 2a 2a 20 64  he table is.** d
1020: 65 6c 65 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  eleted..*/.stati
1030: 63 20 76 6f 69 64 20 61 64 64 4d 6f 64 75 6c 65  c void addModule
1040: 41 72 67 75 6d 65 6e 74 28 73 71 6c 69 74 65 33  Argument(sqlite3
1050: 20 2a 64 62 2c 20 54 61 62 6c 65 20 2a 70 54 61   *db, Table *pTa
1060: 62 6c 65 2c 20 63 68 61 72 20 2a 7a 41 72 67 29  ble, char *zArg)
1070: 7b 0a 20 20 69 6e 74 20 69 20 3d 20 70 54 61 62  {.  int i = pTab
1080: 6c 65 2d 3e 6e 4d 6f 64 75 6c 65 41 72 67 2b 2b  le->nModuleArg++
1090: 3b 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 20 3d  ;.  int nBytes =
10a0: 20 73 69 7a 65 6f 66 28 63 68 61 72 20 2a 29 2a   sizeof(char *)*
10b0: 28 31 2b 70 54 61 62 6c 65 2d 3e 6e 4d 6f 64 75  (1+pTable->nModu
10c0: 6c 65 41 72 67 29 3b 0a 20 20 63 68 61 72 20 2a  leArg);.  char *
10d0: 2a 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20  *azModuleArg;.  
10e0: 61 7a 4d 6f 64 75 6c 65 41 72 67 20 3d 20 73 71  azModuleArg = sq
10f0: 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 64  lite3DbRealloc(d
1100: 62 2c 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64  b, pTable->azMod
1110: 75 6c 65 41 72 67 2c 20 6e 42 79 74 65 73 29 3b  uleArg, nBytes);
1120: 0a 20 20 69 66 28 20 61 7a 4d 6f 64 75 6c 65 41  .  if( azModuleA
1130: 72 67 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74  rg==0 ){.    int
1140: 20 6a 3b 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b   j;.    for(j=0;
1150: 20 6a 3c 69 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20   j<i; j++){.    
1160: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
1170: 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41  Table->azModuleA
1180: 72 67 5b 6a 5d 29 3b 0a 20 20 20 20 7d 0a 20 20  rg[j]);.    }.  
1190: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a    sqlite3_free(z
11a0: 41 72 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Arg);.    sqlite
11b0: 33 5f 66 72 65 65 28 70 54 61 62 6c 65 2d 3e 61  3_free(pTable->a
11c0: 7a 4d 6f 64 75 6c 65 41 72 67 29 3b 0a 20 20 20  zModuleArg);.   
11d0: 20 70 54 61 62 6c 65 2d 3e 6e 4d 6f 64 75 6c 65   pTable->nModule
11e0: 41 72 67 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65  Arg = 0;.  }else
11f0: 7b 0a 20 20 20 20 61 7a 4d 6f 64 75 6c 65 41 72  {.    azModuleAr
1200: 67 5b 69 5d 20 3d 20 7a 41 72 67 3b 0a 20 20 20  g[i] = zArg;.   
1210: 20 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 69 2b 31   azModuleArg[i+1
1220: 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 54 61  ] = 0;.  }.  pTa
1230: 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67  ble->azModuleArg
1240: 20 3d 20 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 0a   = azModuleArg;.
1250: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 72  }../*.** The par
1260: 73 65 72 20 63 61 6c 6c 73 20 74 68 69 73 20 72  ser calls this r
1270: 6f 75 74 69 6e 65 20 77 68 65 6e 20 69 74 20 66  outine when it f
1280: 69 72 73 74 20 73 65 65 73 20 61 20 43 52 45 41  irst sees a CREA
1290: 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45  TE VIRTUAL TABLE
12a0: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 2e 20 20  .** statement.  
12b0: 54 68 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20  The module name 
12c0: 68 61 73 20 62 65 65 6e 20 70 61 72 73 65 64 2c  has been parsed,
12d0: 20 62 75 74 20 74 68 65 20 6f 70 74 69 6f 6e 61   but the optiona
12e0: 6c 20 6c 69 73 74 0a 2a 2a 20 6f 66 20 70 61 72  l list.** of par
12f0: 61 6d 65 74 65 72 73 20 74 68 61 74 20 66 6f 6c  ameters that fol
1300: 6c 6f 77 20 74 68 65 20 6d 6f 64 75 6c 65 20 6e  low the module n
1310: 61 6d 65 20 61 72 65 20 73 74 69 6c 6c 20 70 65  ame are still pe
1320: 6e 64 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  nding..*/.void s
1330: 71 6c 69 74 65 33 56 74 61 62 42 65 67 69 6e 50  qlite3VtabBeginP
1340: 61 72 73 65 28 0a 20 20 50 61 72 73 65 20 2a 70  arse(.  Parse *p
1350: 50 61 72 73 65 2c 20 20 20 20 20 20 20 20 2f 2a  Parse,        /*
1360: 20 50 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74   Parsing context
1370: 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 2a 70 4e 61   */.  Token *pNa
1380: 6d 65 31 2c 20 20 20 20 20 20 20 20 2f 2a 20 4e  me1,        /* N
1390: 61 6d 65 20 6f 66 20 6e 65 77 20 74 61 62 6c 65  ame of new table
13a0: 2c 20 6f 72 20 64 61 74 61 62 61 73 65 20 6e 61  , or database na
13b0: 6d 65 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 2a 70  me */.  Token *p
13c0: 4e 61 6d 65 32 2c 20 20 20 20 20 20 20 20 2f 2a  Name2,        /*
13d0: 20 4e 61 6d 65 20 6f 66 20 6e 65 77 20 74 61 62   Name of new tab
13e0: 6c 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20  le or NULL */.  
13f0: 54 6f 6b 65 6e 20 2a 70 4d 6f 64 75 6c 65 4e 61  Token *pModuleNa
1400: 6d 65 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66  me    /* Name of
1410: 20 74 68 65 20 6d 6f 64 75 6c 65 20 66 6f 72 20   the module for 
1420: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
1430: 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 44  e */.){.  int iD
1440: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b;              
1450: 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20  /* The database 
1460: 74 68 65 20 74 61 62 6c 65 20 69 73 20 62 65 69  the table is bei
1470: 6e 67 20 63 72 65 61 74 65 64 20 69 6e 20 2a 2f  ng created in */
1480: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 6c 65  .  Table *pTable
1490: 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20  ;        /* The 
14a0: 6e 65 77 20 76 69 72 74 75 61 6c 20 74 61 62 6c  new virtual tabl
14b0: 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a  e */.  sqlite3 *
14c0: 64 62 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  db;          /* 
14d0: 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  Database connect
14e0: 69 6f 6e 20 2a 2f 0a 0a 20 20 69 66 28 20 70 50  ion */..  if( pP
14f0: 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20  arse->db->flags 
1500: 26 20 53 51 4c 49 54 45 5f 53 68 61 72 65 64 43  & SQLITE_SharedC
1510: 61 63 68 65 20 29 7b 0a 20 20 20 20 73 71 6c 69  ache ){.    sqli
1520: 74 65 33 45 72 72 6f 72 4d 73 67 28 70 50 61 72  te3ErrorMsg(pPar
1530: 73 65 2c 20 22 43 61 6e 6e 6f 74 20 75 73 65 20  se, "Cannot use 
1540: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69  virtual tables i
1550: 6e 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d  n shared-cache m
1560: 6f 64 65 22 29 3b 0a 20 20 20 20 72 65 74 75 72  ode");.    retur
1570: 6e 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65  n;.  }..  sqlite
1580: 33 53 74 61 72 74 54 61 62 6c 65 28 70 50 61 72  3StartTable(pPar
1590: 73 65 2c 20 70 4e 61 6d 65 31 2c 20 70 4e 61 6d  se, pName1, pNam
15a0: 65 32 2c 20 30 2c 20 30 2c 20 31 2c 20 30 29 3b  e2, 0, 0, 1, 0);
15b0: 0a 20 20 70 54 61 62 6c 65 20 3d 20 70 50 61 72  .  pTable = pPar
15c0: 73 65 2d 3e 70 4e 65 77 54 61 62 6c 65 3b 0a 20  se->pNewTable;. 
15d0: 20 69 66 28 20 70 54 61 62 6c 65 3d 3d 30 20 7c   if( pTable==0 |
15e0: 7c 20 70 50 61 72 73 65 2d 3e 6e 45 72 72 20 29  | pParse->nErr )
15f0: 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 72   return;.  asser
1600: 74 28 20 30 3d 3d 70 54 61 62 6c 65 2d 3e 70 49  t( 0==pTable->pI
1610: 6e 64 65 78 20 29 3b 0a 0a 20 20 64 62 20 3d 20  ndex );..  db = 
1620: 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 69 44  pParse->db;.  iD
1630: 62 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d  b = sqlite3Schem
1640: 61 54 6f 49 6e 64 65 78 28 64 62 2c 20 70 54 61  aToIndex(db, pTa
1650: 62 6c 65 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20  ble->pSchema);. 
1660: 20 61 73 73 65 72 74 28 20 69 44 62 3e 3d 30 20   assert( iDb>=0 
1670: 29 3b 0a 0a 20 20 70 54 61 62 6c 65 2d 3e 69 73  );..  pTable->is
1680: 56 69 72 74 75 61 6c 20 3d 20 31 3b 0a 20 20 70  Virtual = 1;.  p
1690: 54 61 62 6c 65 2d 3e 6e 4d 6f 64 75 6c 65 41 72  Table->nModuleAr
16a0: 67 20 3d 20 30 3b 0a 20 20 61 64 64 4d 6f 64 75  g = 0;.  addModu
16b0: 6c 65 41 72 67 75 6d 65 6e 74 28 64 62 2c 20 70  leArgument(db, p
16c0: 54 61 62 6c 65 2c 20 73 71 6c 69 74 65 33 4e 61  Table, sqlite3Na
16d0: 6d 65 46 72 6f 6d 54 6f 6b 65 6e 28 64 62 2c 20  meFromToken(db, 
16e0: 70 4d 6f 64 75 6c 65 4e 61 6d 65 29 29 3b 0a 20  pModuleName));. 
16f0: 20 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 6d 65   addModuleArgume
1700: 6e 74 28 64 62 2c 20 70 54 61 62 6c 65 2c 20 73  nt(db, pTable, s
1710: 71 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 64  qlite3DbStrDup(d
1720: 62 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  b, db->aDb[iDb].
1730: 7a 4e 61 6d 65 29 29 3b 0a 20 20 61 64 64 4d 6f  zName));.  addMo
1740: 64 75 6c 65 41 72 67 75 6d 65 6e 74 28 64 62 2c  duleArgument(db,
1750: 20 70 54 61 62 6c 65 2c 20 73 71 6c 69 74 65 33   pTable, sqlite3
1760: 44 62 53 74 72 44 75 70 28 64 62 2c 20 70 54 61  DbStrDup(db, pTa
1770: 62 6c 65 2d 3e 7a 4e 61 6d 65 29 29 3b 0a 20 20  ble->zName));.  
1780: 70 50 61 72 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b  pParse->sNameTok
1790: 65 6e 2e 6e 20 3d 20 70 4d 6f 64 75 6c 65 4e 61  en.n = pModuleNa
17a0: 6d 65 2d 3e 7a 20 2b 20 70 4d 6f 64 75 6c 65 4e  me->z + pModuleN
17b0: 61 6d 65 2d 3e 6e 20 2d 20 70 4e 61 6d 65 31 2d  ame->n - pName1-
17c0: 3e 7a 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c  >z;..#ifndef SQL
17d0: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49  ITE_OMIT_AUTHORI
17e0: 5a 41 54 49 4f 4e 0a 20 20 2f 2a 20 43 72 65 61  ZATION.  /* Crea
17f0: 74 69 6e 67 20 61 20 76 69 72 74 75 61 6c 20 74  ting a virtual t
1800: 61 62 6c 65 20 69 6e 76 6f 6b 65 73 20 74 68 65  able invokes the
1810: 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 63   authorization c
1820: 61 6c 6c 62 61 63 6b 20 74 77 69 63 65 2e 0a 20  allback twice.. 
1830: 20 2a 2a 20 54 68 65 20 66 69 72 73 74 20 69 6e   ** The first in
1840: 76 6f 63 61 74 69 6f 6e 2c 20 74 6f 20 6f 62 74  vocation, to obt
1850: 61 69 6e 20 70 65 72 6d 69 73 73 69 6f 6e 20 74  ain permission t
1860: 6f 20 49 4e 53 45 52 54 20 61 20 72 6f 77 20 69  o INSERT a row i
1870: 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73 71 6c  nto the.  ** sql
1880: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
1890: 2c 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65  , has already be
18a0: 65 6e 20 6d 61 64 65 20 62 79 20 73 71 6c 69 74  en made by sqlit
18b0: 65 33 53 74 61 72 74 54 61 62 6c 65 28 29 2e 0a  e3StartTable()..
18c0: 20 20 2a 2a 20 54 68 65 20 73 65 63 6f 6e 64 20    ** The second 
18d0: 63 61 6c 6c 2c 20 74 6f 20 6f 62 74 61 69 6e 20  call, to obtain 
18e0: 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20 63 72  permission to cr
18f0: 65 61 74 65 20 74 68 65 20 74 61 62 6c 65 2c 20  eate the table, 
1900: 69 73 20 6d 61 64 65 20 6e 6f 77 2e 0a 20 20 2a  is made now..  *
1910: 2f 0a 20 20 69 66 28 20 70 54 61 62 6c 65 2d 3e  /.  if( pTable->
1920: 61 7a 4d 6f 64 75 6c 65 41 72 67 20 29 7b 0a 20  azModuleArg ){. 
1930: 20 20 20 73 71 6c 69 74 65 33 41 75 74 68 43 68     sqlite3AuthCh
1940: 65 63 6b 28 70 50 61 72 73 65 2c 20 53 51 4c 49  eck(pParse, SQLI
1950: 54 45 5f 43 52 45 41 54 45 5f 56 54 41 42 4c 45  TE_CREATE_VTABLE
1960: 2c 20 70 54 61 62 6c 65 2d 3e 7a 4e 61 6d 65 2c  , pTable->zName,
1970: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 54   .            pT
1980: 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72  able->azModuleAr
1990: 67 5b 30 5d 2c 20 70 50 61 72 73 65 2d 3e 64 62  g[0], pParse->db
19a0: 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65  ->aDb[iDb].zName
19b0: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a  );.  }.#endif.}.
19c0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
19d0: 69 6e 65 20 74 61 6b 65 73 20 74 68 65 20 6d 6f  ine takes the mo
19e0: 64 75 6c 65 20 61 72 67 75 6d 65 6e 74 20 74 68  dule argument th
19f0: 61 74 20 68 61 73 20 62 65 65 6e 20 61 63 63 75  at has been accu
1a00: 6d 75 6c 61 74 69 6e 67 0a 2a 2a 20 69 6e 20 70  mulating.** in p
1a10: 50 61 72 73 65 2d 3e 7a 41 72 67 5b 5d 20 61 6e  Parse->zArg[] an
1a20: 64 20 61 70 70 65 6e 64 73 20 69 74 20 74 6f 20  d appends it to 
1a30: 74 68 65 20 6c 69 73 74 20 6f 66 20 61 72 67 75  the list of argu
1a40: 6d 65 6e 74 73 20 6f 6e 20 74 68 65 0a 2a 2a 20  ments on the.** 
1a50: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 75  virtual table cu
1a60: 72 72 65 6e 74 6c 79 20 75 6e 64 65 72 20 63 6f  rrently under co
1a70: 6e 73 74 72 75 63 74 69 6f 6e 20 69 6e 20 70 50  nstruction in pP
1a80: 61 72 73 65 2d 3e 70 54 61 62 6c 65 2e 0a 2a 2f  arse->pTable..*/
1a90: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61 64 64  .static void add
1aa0: 41 72 67 75 6d 65 6e 74 54 6f 56 74 61 62 28 50  ArgumentToVtab(P
1ab0: 61 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20  arse *pParse){. 
1ac0: 20 69 66 28 20 70 50 61 72 73 65 2d 3e 73 41 72   if( pParse->sAr
1ad0: 67 2e 7a 20 26 26 20 70 50 61 72 73 65 2d 3e 70  g.z && pParse->p
1ae0: 4e 65 77 54 61 62 6c 65 20 29 7b 0a 20 20 20 20  NewTable ){.    
1af0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20  const char *z = 
1b00: 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 70 50 61  (const char*)pPa
1b10: 72 73 65 2d 3e 73 41 72 67 2e 7a 3b 0a 20 20 20  rse->sArg.z;.   
1b20: 20 69 6e 74 20 6e 20 3d 20 70 50 61 72 73 65 2d   int n = pParse-
1b30: 3e 73 41 72 67 2e 6e 3b 0a 20 20 20 20 73 71 6c  >sArg.n;.    sql
1b40: 69 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73  ite3 *db = pPars
1b50: 65 2d 3e 64 62 3b 0a 20 20 20 20 61 64 64 4d 6f  e->db;.    addMo
1b60: 64 75 6c 65 41 72 67 75 6d 65 6e 74 28 64 62 2c  duleArgument(db,
1b70: 20 70 50 61 72 73 65 2d 3e 70 4e 65 77 54 61 62   pParse->pNewTab
1b80: 6c 65 2c 20 73 71 6c 69 74 65 33 44 62 53 74 72  le, sqlite3DbStr
1b90: 4e 44 75 70 28 64 62 2c 20 7a 2c 20 6e 29 29 3b  NDup(db, z, n));
1ba0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  .  }.}../*.** Th
1bb0: 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73 20 74  e parser calls t
1bc0: 68 69 73 20 72 6f 75 74 69 6e 65 20 61 66 74 65  his routine afte
1bd0: 72 20 74 68 65 20 43 52 45 41 54 45 20 56 49 52  r the CREATE VIR
1be0: 54 55 41 4c 20 54 41 42 4c 45 20 73 74 61 74 65  TUAL TABLE state
1bf0: 6d 65 6e 74 0a 2a 2a 20 68 61 73 20 62 65 65 6e  ment.** has been
1c00: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 70 61 72 73   completely pars
1c10: 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ed..*/.void sqli
1c20: 74 65 33 56 74 61 62 46 69 6e 69 73 68 50 61 72  te3VtabFinishPar
1c30: 73 65 28 50 61 72 73 65 20 2a 70 50 61 72 73 65  se(Parse *pParse
1c40: 2c 20 54 6f 6b 65 6e 20 2a 70 45 6e 64 29 7b 0a  , Token *pEnd){.
1c50: 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20    Table *pTab;  
1c60: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 61 62        /* The tab
1c70: 6c 65 20 62 65 69 6e 67 20 63 6f 6e 73 74 72 75  le being constru
1c80: 63 74 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65  cted */.  sqlite
1c90: 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f 2a  3 *db;        /*
1ca0: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   The database co
1cb0: 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 68  nnection */.  ch
1cc0: 61 72 20 2a 7a 4d 6f 64 75 6c 65 3b 20 20 20 20  ar *zModule;    
1cd0: 20 20 2f 2a 20 54 68 65 20 6d 6f 64 75 6c 65 20    /* The module 
1ce0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
1cf0: 65 3a 20 55 53 49 4e 47 20 6d 6f 64 75 6c 65 6e  e: USING modulen
1d00: 61 6d 65 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20  ame */.  Module 
1d10: 2a 70 4d 6f 64 20 3d 20 30 3b 0a 0a 20 20 61 64  *pMod = 0;..  ad
1d20: 64 41 72 67 75 6d 65 6e 74 54 6f 56 74 61 62 28  dArgumentToVtab(
1d30: 70 50 61 72 73 65 29 3b 0a 20 20 70 50 61 72 73  pParse);.  pPars
1d40: 65 2d 3e 73 41 72 67 2e 7a 20 3d 20 30 3b 0a 0a  e->sArg.z = 0;..
1d50: 20 20 2f 2a 20 4c 6f 6f 6b 75 70 20 74 68 65 20    /* Lookup the 
1d60: 6d 6f 64 75 6c 65 20 6e 61 6d 65 2e 20 2a 2f 0a  module name. */.
1d70: 20 20 70 54 61 62 20 3d 20 70 50 61 72 73 65 2d    pTab = pParse-
1d80: 3e 70 4e 65 77 54 61 62 6c 65 3b 0a 20 20 69 66  >pNewTable;.  if
1d90: 28 20 70 54 61 62 3d 3d 30 20 29 20 72 65 74 75  ( pTab==0 ) retu
1da0: 72 6e 3b 0a 20 20 64 62 20 3d 20 70 50 61 72 73  rn;.  db = pPars
1db0: 65 2d 3e 64 62 3b 0a 20 20 69 66 28 20 70 54 61  e->db;.  if( pTa
1dc0: 62 2d 3e 6e 4d 6f 64 75 6c 65 41 72 67 3c 31 20  b->nModuleArg<1 
1dd0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 7a 4d 6f 64  ) return;.  zMod
1de0: 75 6c 65 20 3d 20 70 54 61 62 2d 3e 61 7a 4d 6f  ule = pTab->azMo
1df0: 64 75 6c 65 41 72 67 5b 30 5d 3b 0a 20 20 70 4d  duleArg[0];.  pM
1e00: 6f 64 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73  od = (Module *)s
1e10: 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 26  qlite3HashFind(&
1e20: 64 62 2d 3e 61 4d 6f 64 75 6c 65 2c 20 7a 4d 6f  db->aModule, zMo
1e30: 64 75 6c 65 2c 20 73 74 72 6c 65 6e 28 7a 4d 6f  dule, strlen(zMo
1e40: 64 75 6c 65 29 29 3b 0a 20 20 70 54 61 62 2d 3e  dule));.  pTab->
1e50: 70 4d 6f 64 20 3d 20 70 4d 6f 64 3b 0a 20 20 0a  pMod = pMod;.  .
1e60: 20 20 2f 2a 20 49 66 20 74 68 65 20 43 52 45 41    /* If the CREA
1e70: 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45  TE VIRTUAL TABLE
1e80: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 62 65   statement is be
1e90: 69 6e 67 20 65 6e 74 65 72 65 64 20 66 6f 72 20  ing entered for 
1ea0: 74 68 65 0a 20 20 2a 2a 20 66 69 72 73 74 20 74  the.  ** first t
1eb0: 69 6d 65 20 28 69 6e 20 6f 74 68 65 72 20 77 6f  ime (in other wo
1ec0: 72 64 73 20 69 66 20 74 68 65 20 76 69 72 74 75  rds if the virtu
1ed0: 61 6c 20 74 61 62 6c 65 20 69 73 20 61 63 74 75  al table is actu
1ee0: 61 6c 6c 79 20 62 65 69 6e 67 0a 20 20 2a 2a 20  ally being.  ** 
1ef0: 63 72 65 61 74 65 64 20 6e 6f 77 20 69 6e 73 74  created now inst
1f00: 65 61 64 20 6f 66 20 6a 75 73 74 20 62 65 69 6e  ead of just bein
1f10: 67 20 72 65 61 64 20 6f 75 74 20 6f 66 20 73 71  g read out of sq
1f20: 6c 69 74 65 5f 6d 61 73 74 65 72 29 20 74 68 65  lite_master) the
1f30: 6e 0a 20 20 2a 2a 20 64 6f 20 61 64 64 69 74 69  n.  ** do additi
1f40: 6f 6e 61 6c 20 69 6e 69 74 69 61 6c 69 7a 61 74  onal initializat
1f50: 69 6f 6e 20 77 6f 72 6b 20 61 6e 64 20 73 74 6f  ion work and sto
1f60: 72 65 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  re the statement
1f70: 20 74 65 78 74 0a 20 20 2a 2a 20 69 6e 20 74 68   text.  ** in th
1f80: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  e sqlite_master 
1f90: 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66  table..  */.  if
1fa0: 28 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79  ( !db->init.busy
1fb0: 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53   ){.    char *zS
1fc0: 74 6d 74 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a  tmt;.    char *z
1fd0: 57 68 65 72 65 3b 0a 20 20 20 20 69 6e 74 20 69  Where;.    int i
1fe0: 44 62 3b 0a 20 20 20 20 56 64 62 65 20 2a 76 3b  Db;.    Vdbe *v;
1ff0: 0a 0a 20 20 20 20 2f 2a 20 43 6f 6d 70 75 74 65  ..    /* Compute
2000: 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 65   the complete te
2010: 78 74 20 6f 66 20 74 68 65 20 43 52 45 41 54 45  xt of the CREATE
2020: 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73   VIRTUAL TABLE s
2030: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 20 20  tatement */.    
2040: 69 66 28 20 70 45 6e 64 20 29 7b 0a 20 20 20 20  if( pEnd ){.    
2050: 20 20 70 50 61 72 73 65 2d 3e 73 4e 61 6d 65 54    pParse->sNameT
2060: 6f 6b 65 6e 2e 6e 20 3d 20 70 45 6e 64 2d 3e 7a  oken.n = pEnd->z
2070: 20 2d 20 70 50 61 72 73 65 2d 3e 73 4e 61 6d 65   - pParse->sName
2080: 54 6f 6b 65 6e 2e 7a 20 2b 20 70 45 6e 64 2d 3e  Token.z + pEnd->
2090: 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 53 74  n;.    }.    zSt
20a0: 6d 74 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69  mt = sqlite3MPri
20b0: 6e 74 66 28 64 62 2c 20 22 43 52 45 41 54 45 20  ntf(db, "CREATE 
20c0: 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 25 54  VIRTUAL TABLE %T
20d0: 22 2c 20 26 70 50 61 72 73 65 2d 3e 73 4e 61 6d  ", &pParse->sNam
20e0: 65 54 6f 6b 65 6e 29 3b 0a 0a 20 20 20 20 2f 2a  eToken);..    /*
20f0: 20 41 20 73 6c 6f 74 20 66 6f 72 20 74 68 65 20   A slot for the 
2100: 72 65 63 6f 72 64 20 68 61 73 20 61 6c 72 65 61  record has alrea
2110: 64 79 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65  dy been allocate
2120: 64 20 69 6e 20 74 68 65 20 0a 20 20 20 20 2a 2a  d in the .    **
2130: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74   SQLITE_MASTER t
2140: 61 62 6c 65 2e 20 20 57 65 20 6a 75 73 74 20 6e  able.  We just n
2150: 65 65 64 20 74 6f 20 75 70 64 61 74 65 20 74 68  eed to update th
2160: 61 74 20 73 6c 6f 74 20 77 69 74 68 20 61 6c 6c  at slot with all
2170: 0a 20 20 20 20 2a 2a 20 74 68 65 20 69 6e 66 6f  .    ** the info
2180: 72 6d 61 74 69 6f 6e 20 77 65 27 76 65 20 63 6f  rmation we've co
2190: 6c 6c 65 63 74 65 64 2e 20 20 0a 20 20 20 20 2a  llected.  .    *
21a0: 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 56 4d 20  *.    ** The VM 
21b0: 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 20  register number 
21c0: 70 50 61 72 73 65 2d 3e 72 65 67 52 6f 77 69 64  pParse->regRowid
21d0: 20 68 6f 6c 64 73 20 74 68 65 20 72 6f 77 69 64   holds the rowid
21e0: 20 6f 66 20 61 6e 0a 20 20 20 20 2a 2a 20 65 6e   of an.    ** en
21f0: 74 72 79 20 69 6e 20 74 68 65 20 73 71 6c 69 74  try in the sqlit
2200: 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20 74  e_master table t
2210: 68 74 20 77 61 73 20 63 72 65 61 74 65 64 20 66  ht was created f
2220: 6f 72 20 74 68 69 73 20 76 74 61 62 0a 20 20 20  or this vtab.   
2230: 20 2a 2a 20 62 79 20 73 71 6c 69 74 65 33 53 74   ** by sqlite3St
2240: 61 72 74 54 61 62 6c 65 28 29 2e 0a 20 20 20 20  artTable()..    
2250: 2a 2f 0a 20 20 20 20 69 44 62 20 3d 20 73 71 6c  */.    iDb = sql
2260: 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65  ite3SchemaToInde
2270: 78 28 64 62 2c 20 70 54 61 62 2d 3e 70 53 63 68  x(db, pTab->pSch
2280: 65 6d 61 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ema);.    sqlite
2290: 33 4e 65 73 74 65 64 50 61 72 73 65 28 70 50 61  3NestedParse(pPa
22a0: 72 73 65 2c 0a 20 20 20 20 20 20 22 55 50 44 41  rse,.      "UPDA
22b0: 54 45 20 25 51 2e 25 73 20 22 0a 20 20 20 20 20  TE %Q.%s ".     
22c0: 20 20 20 20 22 53 45 54 20 74 79 70 65 3d 27 74      "SET type='t
22d0: 61 62 6c 65 27 2c 20 6e 61 6d 65 3d 25 51 2c 20  able', name=%Q, 
22e0: 74 62 6c 5f 6e 61 6d 65 3d 25 51 2c 20 72 6f 6f  tbl_name=%Q, roo
22f0: 74 70 61 67 65 3d 30 2c 20 73 71 6c 3d 25 51 20  tpage=0, sql=%Q 
2300: 22 0a 20 20 20 20 20 20 20 22 57 48 45 52 45 20  ".       "WHERE 
2310: 72 6f 77 69 64 3d 23 25 64 22 2c 0a 20 20 20 20  rowid=#%d",.    
2320: 20 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a    db->aDb[iDb].z
2330: 4e 61 6d 65 2c 20 53 43 48 45 4d 41 5f 54 41 42  Name, SCHEMA_TAB
2340: 4c 45 28 69 44 62 29 2c 0a 20 20 20 20 20 20 70  LE(iDb),.      p
2350: 54 61 62 2d 3e 7a 4e 61 6d 65 2c 0a 20 20 20 20  Tab->zName,.    
2360: 20 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 0a 20    pTab->zName,. 
2370: 20 20 20 20 20 7a 53 74 6d 74 2c 0a 20 20 20 20       zStmt,.    
2380: 20 20 70 50 61 72 73 65 2d 3e 72 65 67 52 6f 77    pParse->regRow
2390: 69 64 0a 20 20 20 20 29 3b 0a 20 20 20 20 73 71  id.    );.    sq
23a0: 6c 69 74 65 33 5f 66 72 65 65 28 7a 53 74 6d 74  lite3_free(zStmt
23b0: 29 3b 0a 20 20 20 20 76 20 3d 20 73 71 6c 69 74  );.    v = sqlit
23c0: 65 33 47 65 74 56 64 62 65 28 70 50 61 72 73 65  e3GetVdbe(pParse
23d0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 68  );.    sqlite3Ch
23e0: 61 6e 67 65 43 6f 6f 6b 69 65 28 70 50 61 72 73  angeCookie(pPars
23f0: 65 2c 20 69 44 62 29 3b 0a 0a 20 20 20 20 73 71  e, iDb);..    sq
2400: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28  lite3VdbeAddOp2(
2410: 76 2c 20 4f 50 5f 45 78 70 69 72 65 2c 20 30 2c  v, OP_Expire, 0,
2420: 20 30 29 3b 0a 20 20 20 20 7a 57 68 65 72 65 20   0);.    zWhere 
2430: 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66  = sqlite3MPrintf
2440: 28 64 62 2c 20 22 6e 61 6d 65 3d 27 25 71 27 22  (db, "name='%q'"
2450: 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a  , pTab->zName);.
2460: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
2470: 64 64 4f 70 34 28 76 2c 20 4f 50 5f 50 61 72 73  ddOp4(v, OP_Pars
2480: 65 53 63 68 65 6d 61 2c 20 69 44 62 2c 20 31 2c  eSchema, iDb, 1,
2490: 20 30 2c 20 7a 57 68 65 72 65 2c 20 50 34 5f 44   0, zWhere, P4_D
24a0: 59 4e 41 4d 49 43 29 3b 0a 20 20 20 20 73 71 6c  YNAMIC);.    sql
24b0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 34 28 76  ite3VdbeAddOp4(v
24c0: 2c 20 4f 50 5f 56 43 72 65 61 74 65 2c 20 69 44  , OP_VCreate, iD
24d0: 62 2c 20 30 2c 20 30 2c 20 0a 20 20 20 20 20 20  b, 0, 0, .      
24e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
24f0: 20 20 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20     pTab->zName, 
2500: 73 74 72 6c 65 6e 28 70 54 61 62 2d 3e 7a 4e 61  strlen(pTab->zNa
2510: 6d 65 29 20 2b 20 31 29 3b 0a 20 20 7d 0a 0a 20  me) + 1);.  }.. 
2520: 20 2f 2a 20 49 66 20 77 65 20 61 72 65 20 72 65   /* If we are re
2530: 72 65 61 64 69 6e 67 20 74 68 65 20 73 71 6c 69  reading the sqli
2540: 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20  te_master table 
2550: 63 72 65 61 74 65 20 74 68 65 20 69 6e 2d 6d 65  create the in-me
2560: 6d 6f 72 79 0a 20 20 2a 2a 20 72 65 63 6f 72 64  mory.  ** record
2570: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20 49   of the table. I
2580: 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 68 61 73  f the module has
2590: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 72 65   already been re
25a0: 67 69 73 74 65 72 65 64 2c 0a 20 20 2a 2a 20 61  gistered,.  ** a
25b0: 6c 73 6f 20 63 61 6c 6c 20 74 68 65 20 78 43 6f  lso call the xCo
25c0: 6e 6e 65 63 74 20 6d 65 74 68 6f 64 20 68 65 72  nnect method her
25d0: 65 2e 0a 20 20 2a 2f 0a 20 20 65 6c 73 65 20 7b  e..  */.  else {
25e0: 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 4f 6c 64  .    Table *pOld
25f0: 3b 0a 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53  ;.    Schema *pS
2600: 63 68 65 6d 61 20 3d 20 70 54 61 62 2d 3e 70 53  chema = pTab->pS
2610: 63 68 65 6d 61 3b 0a 20 20 20 20 63 6f 6e 73 74  chema;.    const
2620: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 70   char *zName = p
2630: 54 61 62 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20  Tab->zName;.    
2640: 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 74 72 6c  int nName = strl
2650: 65 6e 28 7a 4e 61 6d 65 29 20 2b 20 31 3b 0a 20  en(zName) + 1;. 
2660: 20 20 20 70 4f 6c 64 20 3d 20 73 71 6c 69 74 65     pOld = sqlite
2670: 33 48 61 73 68 49 6e 73 65 72 74 28 26 70 53 63  3HashInsert(&pSc
2680: 68 65 6d 61 2d 3e 74 62 6c 48 61 73 68 2c 20 7a  hema->tblHash, z
2690: 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 70 54 61  Name, nName, pTa
26a0: 62 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64  b);.    if( pOld
26b0: 20 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 6d 61   ){.      db->ma
26c0: 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a  llocFailed = 1;.
26d0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 54        assert( pT
26e0: 61 62 3d 3d 70 4f 6c 64 20 29 3b 20 20 2f 2a 20  ab==pOld );  /* 
26f0: 4d 61 6c 6c 6f 63 20 6d 75 73 74 20 68 61 76 65  Malloc must have
2700: 20 66 61 69 6c 65 64 20 69 6e 73 69 64 65 20 48   failed inside H
2710: 61 73 68 49 6e 73 65 72 74 28 29 20 2a 2f 0a 20  ashInsert() */. 
2720: 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20       return;.   
2730: 20 7d 0a 20 20 20 20 70 53 63 68 65 6d 61 2d 3e   }.    pSchema->
2740: 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b  db = pParse->db;
2750: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 70 4e 65  .    pParse->pNe
2760: 77 54 61 62 6c 65 20 3d 20 30 3b 0a 20 20 7d 0a  wTable = 0;.  }.
2770: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 72  }../*.** The par
2780: 73 65 72 20 63 61 6c 6c 73 20 74 68 69 73 20 72  ser calls this r
2790: 6f 75 74 69 6e 65 20 77 68 65 6e 20 69 74 20 73  outine when it s
27a0: 65 65 73 20 74 68 65 20 66 69 72 73 74 20 74 6f  ees the first to
27b0: 6b 65 6e 0a 2a 2a 20 6f 66 20 61 6e 20 61 72 67  ken.** of an arg
27c0: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 6d 6f 64  ument to the mod
27d0: 75 6c 65 20 6e 61 6d 65 20 69 6e 20 61 20 43 52  ule name in a CR
27e0: 45 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42  EATE VIRTUAL TAB
27f0: 4c 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f  LE statement..*/
2800: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61  .void sqlite3Vta
2810: 62 41 72 67 49 6e 69 74 28 50 61 72 73 65 20 2a  bArgInit(Parse *
2820: 70 50 61 72 73 65 29 7b 0a 20 20 61 64 64 41 72  pParse){.  addAr
2830: 67 75 6d 65 6e 74 54 6f 56 74 61 62 28 70 50 61  gumentToVtab(pPa
2840: 72 73 65 29 3b 0a 20 20 70 50 61 72 73 65 2d 3e  rse);.  pParse->
2850: 73 41 72 67 2e 7a 20 3d 20 30 3b 0a 20 20 70 50  sArg.z = 0;.  pP
2860: 61 72 73 65 2d 3e 73 41 72 67 2e 6e 20 3d 20 30  arse->sArg.n = 0
2870: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70  ;.}../*.** The p
2880: 61 72 73 65 72 20 63 61 6c 6c 73 20 74 68 69 73  arser calls this
2890: 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 65 61 63   routine for eac
28a0: 68 20 74 6f 6b 65 6e 20 61 66 74 65 72 20 74 68  h token after th
28b0: 65 20 66 69 72 73 74 20 74 6f 6b 65 6e 0a 2a 2a  e first token.**
28c0: 20 69 6e 20 61 6e 20 61 72 67 75 6d 65 6e 74 20   in an argument 
28d0: 74 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 6e 61  to the module na
28e0: 6d 65 20 69 6e 20 61 20 43 52 45 41 54 45 20 56  me in a CREATE V
28f0: 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 61  IRTUAL TABLE sta
2900: 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20  tement..*/.void 
2910: 73 71 6c 69 74 65 33 56 74 61 62 41 72 67 45 78  sqlite3VtabArgEx
2920: 74 65 6e 64 28 50 61 72 73 65 20 2a 70 50 61 72  tend(Parse *pPar
2930: 73 65 2c 20 54 6f 6b 65 6e 20 2a 70 29 7b 0a 20  se, Token *p){. 
2940: 20 54 6f 6b 65 6e 20 2a 70 41 72 67 20 3d 20 26   Token *pArg = &
2950: 70 50 61 72 73 65 2d 3e 73 41 72 67 3b 0a 20 20  pParse->sArg;.  
2960: 69 66 28 20 70 41 72 67 2d 3e 7a 3d 3d 30 20 29  if( pArg->z==0 )
2970: 7b 0a 20 20 20 20 70 41 72 67 2d 3e 7a 20 3d 20  {.    pArg->z = 
2980: 70 2d 3e 7a 3b 0a 20 20 20 20 70 41 72 67 2d 3e  p->z;.    pArg->
2990: 6e 20 3d 20 70 2d 3e 6e 3b 0a 20 20 7d 65 6c 73  n = p->n;.  }els
29a0: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 70 41  e{.    assert(pA
29b0: 72 67 2d 3e 7a 20 3c 20 70 2d 3e 7a 29 3b 0a 20  rg->z < p->z);. 
29c0: 20 20 20 70 41 72 67 2d 3e 6e 20 3d 20 28 70 2d     pArg->n = (p-
29d0: 3e 7a 20 2b 20 70 2d 3e 6e 20 2d 20 70 41 72 67  >z + p->n - pArg
29e0: 2d 3e 7a 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  ->z);.  }.}../*.
29f0: 2a 2a 20 49 6e 76 6f 6b 65 20 61 20 76 69 72 74  ** Invoke a virt
2a00: 75 61 6c 20 74 61 62 6c 65 20 63 6f 6e 73 74 72  ual table constr
2a10: 75 63 74 6f 72 20 28 65 69 74 68 65 72 20 78 43  uctor (either xC
2a20: 72 65 61 74 65 20 6f 72 20 78 43 6f 6e 6e 65 63  reate or xConnec
2a30: 74 29 2e 20 54 68 65 0a 2a 2a 20 70 6f 69 6e 74  t). The.** point
2a40: 65 72 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69  er to the functi
2a50: 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 69 73 20  on to invoke is 
2a60: 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 6f  passed as the fo
2a70: 75 72 74 68 20 70 61 72 61 6d 65 74 65 72 0a 2a  urth parameter.*
2a80: 2a 20 74 6f 20 74 68 69 73 20 70 72 6f 63 65 64  * to this proced
2a90: 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ure..*/.static i
2aa0: 6e 74 20 76 74 61 62 43 61 6c 6c 43 6f 6e 73 74  nt vtabCallConst
2ab0: 72 75 63 74 6f 72 28 0a 20 20 73 71 6c 69 74 65  ructor(.  sqlite
2ac0: 33 20 2a 64 62 2c 20 0a 20 20 54 61 62 6c 65 20  3 *db, .  Table 
2ad0: 2a 70 54 61 62 2c 0a 20 20 4d 6f 64 75 6c 65 20  *pTab,.  Module 
2ae0: 2a 70 4d 6f 64 2c 0a 20 20 69 6e 74 20 28 2a 78  *pMod,.  int (*x
2af0: 43 6f 6e 73 74 72 75 63 74 29 28 73 71 6c 69 74  Construct)(sqlit
2b00: 65 33 2a 2c 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  e3*,void*,int,co
2b10: 6e 73 74 20 63 68 61 72 2a 63 6f 6e 73 74 2a 2c  nst char*const*,
2b20: 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 2a 2c 63  sqlite3_vtab**,c
2b30: 68 61 72 2a 2a 29 2c 0a 20 20 63 68 61 72 20 2a  har**),.  char *
2b40: 2a 70 7a 45 72 72 0a 29 7b 0a 20 20 69 6e 74 20  *pzErr.){.  int 
2b50: 72 63 3b 0a 20 20 69 6e 74 20 72 63 32 3b 0a 20  rc;.  int rc2;. 
2b60: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70   sqlite3_vtab *p
2b70: 56 74 61 62 20 3d 20 30 3b 0a 20 20 63 6f 6e 73  Vtab = 0;.  cons
2b80: 74 20 63 68 61 72 20 2a 63 6f 6e 73 74 2a 61 7a  t char *const*az
2b90: 41 72 67 20 3d 20 28 63 6f 6e 73 74 20 63 68 61  Arg = (const cha
2ba0: 72 20 2a 63 6f 6e 73 74 2a 29 70 54 61 62 2d 3e  r *const*)pTab->
2bb0: 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20 69  azModuleArg;.  i
2bc0: 6e 74 20 6e 41 72 67 20 3d 20 70 54 61 62 2d 3e  nt nArg = pTab->
2bd0: 6e 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20 63 68  nModuleArg;.  ch
2be0: 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 20  ar *zErr = 0;.  
2bf0: 63 68 61 72 20 2a 7a 4d 6f 64 75 6c 65 4e 61 6d  char *zModuleNam
2c00: 65 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e  e = sqlite3MPrin
2c10: 74 66 28 64 62 2c 20 22 25 73 22 2c 20 70 54 61  tf(db, "%s", pTa
2c20: 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 0a 20 20 69 66  b->zName);..  if
2c30: 28 20 21 7a 4d 6f 64 75 6c 65 4e 61 6d 65 20 29  ( !zModuleName )
2c40: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
2c50: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a  ITE_NOMEM;.  }..
2c60: 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 70    assert( !db->p
2c70: 56 54 61 62 20 29 3b 0a 20 20 61 73 73 65 72 74  VTab );.  assert
2c80: 28 20 78 43 6f 6e 73 74 72 75 63 74 20 29 3b 0a  ( xConstruct );.
2c90: 0a 20 20 64 62 2d 3e 70 56 54 61 62 20 3d 20 70  .  db->pVTab = p
2ca0: 54 61 62 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  Tab;.  rc = sqli
2cb0: 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29  te3SafetyOff(db)
2cc0: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  ;.  assert( rc==
2cd0: 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 72  SQLITE_OK );.  r
2ce0: 63 20 3d 20 78 43 6f 6e 73 74 72 75 63 74 28 64  c = xConstruct(d
2cf0: 62 2c 20 70 4d 6f 64 2d 3e 70 41 75 78 2c 20 6e  b, pMod->pAux, n
2d00: 41 72 67 2c 20 61 7a 41 72 67 2c 20 26 70 56 74  Arg, azArg, &pVt
2d10: 61 62 2c 20 26 7a 45 72 72 29 3b 0a 20 20 72 63  ab, &zErr);.  rc
2d20: 32 20 3d 20 73 71 6c 69 74 65 33 53 61 66 65 74  2 = sqlite3Safet
2d30: 79 4f 6e 28 64 62 29 3b 0a 20 20 69 66 28 20 72  yOn(db);.  if( r
2d40: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
2d50: 70 56 74 61 62 20 29 7b 0a 20 20 20 20 70 56 74  pVtab ){.    pVt
2d60: 61 62 2d 3e 70 4d 6f 64 75 6c 65 20 3d 20 70 4d  ab->pModule = pM
2d70: 6f 64 2d 3e 70 4d 6f 64 75 6c 65 3b 0a 20 20 20  od->pModule;.   
2d80: 20 70 56 74 61 62 2d 3e 6e 52 65 66 20 3d 20 31   pVtab->nRef = 1
2d90: 3b 0a 20 20 20 20 70 54 61 62 2d 3e 70 56 74 61  ;.    pTab->pVta
2da0: 62 20 3d 20 70 56 74 61 62 3b 0a 20 20 7d 0a 0a  b = pVtab;.  }..
2db0: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21    if( SQLITE_OK!
2dc0: 3d 72 63 20 29 7b 0a 20 20 20 20 69 66 28 20 7a  =rc ){.    if( z
2dd0: 45 72 72 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  Err==0 ){.      
2de0: 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33  *pzErr = sqlite3
2df0: 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 76 74 61  MPrintf(db, "vta
2e00: 62 6c 65 20 63 6f 6e 73 74 72 75 63 74 6f 72 20  ble constructor 
2e10: 66 61 69 6c 65 64 3a 20 25 73 22 2c 20 7a 4d 6f  failed: %s", zMo
2e20: 64 75 6c 65 4e 61 6d 65 29 3b 0a 20 20 20 20 7d  duleName);.    }
2e30: 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 2a 70 7a  else {.      *pz
2e40: 45 72 72 20 3d 20 73 71 6c 69 74 65 33 4d 50 72  Err = sqlite3MPr
2e50: 69 6e 74 66 28 64 62 2c 20 22 25 73 22 2c 20 7a  intf(db, "%s", z
2e60: 45 72 72 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  Err);.      sqli
2e70: 74 65 33 5f 66 72 65 65 28 7a 45 72 72 29 3b 0a  te3_free(zErr);.
2e80: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66      }.  }else if
2e90: 28 20 64 62 2d 3e 70 56 54 61 62 20 29 7b 0a 20  ( db->pVTab ){. 
2ea0: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a     const char *z
2eb0: 46 6f 72 6d 61 74 20 3d 20 22 76 74 61 62 6c 65  Format = "vtable
2ec0: 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 64 69 64   constructor did
2ed0: 20 6e 6f 74 20 64 65 63 6c 61 72 65 20 73 63 68   not declare sch
2ee0: 65 6d 61 3a 20 25 73 22 3b 0a 20 20 20 20 2a 70  ema: %s";.    *p
2ef0: 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33 4d 50  zErr = sqlite3MP
2f00: 72 69 6e 74 66 28 64 62 2c 20 7a 46 6f 72 6d 61  rintf(db, zForma
2f10: 74 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b  t, pTab->zName);
2f20: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2f30: 5f 45 52 52 4f 52 3b 0a 20 20 7d 20 0a 20 20 69  _ERROR;.  } .  i
2f40: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
2f50: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 72 63 32   ){.    rc = rc2
2f60: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 70 56 54 61  ;.  }.  db->pVTa
2f70: 62 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33  b = 0;.  sqlite3
2f80: 5f 66 72 65 65 28 7a 4d 6f 64 75 6c 65 4e 61 6d  _free(zModuleNam
2f90: 65 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 65 76 65  e);..  /* If eve
2fa0: 72 79 74 68 69 6e 67 20 77 65 6e 74 20 61 63 63  rything went acc
2fb0: 6f 72 64 69 6e 67 20 74 6f 20 70 6c 61 6e 2c 20  ording to plan, 
2fc0: 6c 6f 6f 70 20 74 68 72 6f 75 67 68 20 74 68 65  loop through the
2fd0: 20 63 6f 6c 75 6d 6e 73 0a 20 20 2a 2a 20 6f 66   columns.  ** of
2fe0: 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 73 65   the table to se
2ff0: 65 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 6d  e if any of them
3000: 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 74 6f 6b   contain the tok
3010: 65 6e 20 22 68 69 64 64 65 6e 22 2e 0a 20 20 2a  en "hidden"..  *
3020: 2a 20 49 66 20 73 6f 2c 20 73 65 74 20 74 68 65  * If so, set the
3030: 20 43 6f 6c 75 6d 6e 2e 69 73 48 69 64 64 65 6e   Column.isHidden
3040: 20 66 6c 61 67 20 61 6e 64 20 72 65 6d 6f 76 65   flag and remove
3050: 20 74 68 65 20 74 6f 6b 65 6e 20 66 72 6f 6d 0a   the token from.
3060: 20 20 2a 2a 20 74 68 65 20 74 79 70 65 20 73 74    ** the type st
3070: 72 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ring..  */.  if(
3080: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
3090: 7b 0a 20 20 20 20 69 6e 74 20 69 43 6f 6c 3b 0a  {.    int iCol;.
30a0: 20 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20      for(iCol=0; 
30b0: 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b  iCol<pTab->nCol;
30c0: 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20   iCol++){.      
30d0: 63 68 61 72 20 2a 7a 54 79 70 65 20 3d 20 70 54  char *zType = pT
30e0: 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e 7a  ab->aCol[iCol].z
30f0: 54 79 70 65 3b 0a 20 20 20 20 20 20 69 6e 74 20  Type;.      int 
3100: 6e 54 79 70 65 3b 0a 20 20 20 20 20 20 69 6e 74  nType;.      int
3110: 20 69 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66   i = 0;.      if
3120: 28 20 21 7a 54 79 70 65 20 29 20 63 6f 6e 74 69  ( !zType ) conti
3130: 6e 75 65 3b 0a 20 20 20 20 20 20 6e 54 79 70 65  nue;.      nType
3140: 20 3d 20 73 74 72 6c 65 6e 28 7a 54 79 70 65 29   = strlen(zType)
3150: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69  ;.      if( sqli
3160: 74 65 33 53 74 72 4e 49 43 6d 70 28 22 68 69 64  te3StrNICmp("hid
3170: 64 65 6e 22 2c 20 7a 54 79 70 65 2c 20 36 29 20  den", zType, 6) 
3180: 7c 7c 20 28 7a 54 79 70 65 5b 36 5d 20 26 26 20  || (zType[6] && 
3190: 7a 54 79 70 65 5b 36 5d 21 3d 27 20 27 29 20 29  zType[6]!=' ') )
31a0: 7b 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d  {.        for(i=
31b0: 30 3b 20 69 3c 6e 54 79 70 65 3b 20 69 2b 2b 29  0; i<nType; i++)
31c0: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20  {.          if( 
31d0: 28 30 3d 3d 73 71 6c 69 74 65 33 53 74 72 4e 49  (0==sqlite3StrNI
31e0: 43 6d 70 28 22 20 68 69 64 64 65 6e 22 2c 20 26  Cmp(" hidden", &
31f0: 7a 54 79 70 65 5b 69 5d 2c 20 37 29 29 0a 20 20  zType[i], 7)).  
3200: 20 20 20 20 20 20 20 20 20 26 26 20 28 7a 54 79           && (zTy
3210: 70 65 5b 69 2b 37 5d 3d 3d 27 5c 30 27 20 7c 7c  pe[i+7]=='\0' ||
3220: 20 7a 54 79 70 65 5b 69 2b 37 5d 3d 3d 27 20 27   zType[i+7]==' '
3230: 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20  ).          ){. 
3240: 20 20 20 20 20 20 20 20 20 20 20 69 2b 2b 3b 0a             i++;.
3250: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61              brea
3260: 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  k;.          }. 
3270: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
3280: 0a 20 20 20 20 20 20 69 66 28 20 69 3c 6e 54 79  .      if( i<nTy
3290: 70 65 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e  pe ){.        in
32a0: 74 20 6a 3b 0a 20 20 20 20 20 20 20 20 69 6e 74  t j;.        int
32b0: 20 6e 44 65 6c 20 3d 20 36 20 2b 20 28 7a 54 79   nDel = 6 + (zTy
32c0: 70 65 5b 69 2b 36 5d 20 3f 20 31 20 3a 20 30 29  pe[i+6] ? 1 : 0)
32d0: 3b 0a 20 20 20 20 20 20 20 20 66 6f 72 28 6a 3d  ;.        for(j=
32e0: 69 3b 20 28 6a 2b 6e 44 65 6c 29 3c 3d 6e 54 79  i; (j+nDel)<=nTy
32f0: 70 65 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20  pe; j++){.      
3300: 20 20 20 20 7a 54 79 70 65 5b 6a 5d 20 3d 20 7a      zType[j] = z
3310: 54 79 70 65 5b 6a 2b 6e 44 65 6c 5d 3b 0a 20 20  Type[j+nDel];.  
3320: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
3330: 69 66 28 20 7a 54 79 70 65 5b 69 5d 3d 3d 27 5c  if( zType[i]=='\
3340: 30 27 20 26 26 20 69 3e 30 20 29 7b 0a 20 20 20  0' && i>0 ){.   
3350: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 7a 54         assert(zT
3360: 79 70 65 5b 69 2d 31 5d 3d 3d 27 20 27 29 3b 0a  ype[i-1]==' ');.
3370: 20 20 20 20 20 20 20 20 20 20 7a 54 79 70 65 5b            zType[
3380: 69 2d 31 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20  i-1] = '\0';.   
3390: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70       }.        p
33a0: 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e  Tab->aCol[iCol].
33b0: 69 73 48 69 64 64 65 6e 20 3d 20 31 3b 0a 20 20  isHidden = 1;.  
33c0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
33d0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
33e0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
33f0: 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64 20 62  ion is invoked b
3400: 79 20 74 68 65 20 70 61 72 73 65 72 20 74 6f 20  y the parser to 
3410: 63 61 6c 6c 20 74 68 65 20 78 43 6f 6e 6e 65 63  call the xConnec
3420: 74 28 29 20 6d 65 74 68 6f 64 0a 2a 2a 20 6f 66  t() method.** of
3430: 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62   the virtual tab
3440: 6c 65 20 70 54 61 62 2e 20 49 66 20 61 6e 20 65  le pTab. If an e
3450: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 61 6e 20  rror occurs, an 
3460: 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65  error code is re
3470: 74 75 72 6e 65 64 20 0a 2a 2a 20 61 6e 64 20 61  turned .** and a
3480: 6e 20 65 72 72 6f 72 20 6c 65 66 74 20 69 6e 20  n error left in 
3490: 70 50 61 72 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  pParse..**.** Th
34a0: 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d  is call is a no-
34b0: 6f 70 20 69 66 20 74 61 62 6c 65 20 70 54 61 62  op if table pTab
34c0: 20 69 73 20 6e 6f 74 20 61 20 76 69 72 74 75 61   is not a virtua
34d0: 6c 20 74 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20  l table..*/.int 
34e0: 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 43  sqlite3VtabCallC
34f0: 6f 6e 6e 65 63 74 28 50 61 72 73 65 20 2a 70 50  onnect(Parse *pP
3500: 61 72 73 65 2c 20 54 61 62 6c 65 20 2a 70 54 61  arse, Table *pTa
3510: 62 29 7b 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d  b){.  Module *pM
3520: 6f 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  od;.  int rc = S
3530: 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28  QLITE_OK;..  if(
3540: 20 21 70 54 61 62 20 7c 7c 20 21 70 54 61 62 2d   !pTab || !pTab-
3550: 3e 69 73 56 69 72 74 75 61 6c 20 7c 7c 20 70 54  >isVirtual || pT
3560: 61 62 2d 3e 70 56 74 61 62 20 29 7b 0a 20 20 20  ab->pVtab ){.   
3570: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
3580: 4b 3b 0a 20 20 7d 0a 0a 20 20 70 4d 6f 64 20 3d  K;.  }..  pMod =
3590: 20 70 54 61 62 2d 3e 70 4d 6f 64 3b 0a 20 20 69   pTab->pMod;.  i
35a0: 66 28 20 21 70 4d 6f 64 20 29 7b 0a 20 20 20 20  f( !pMod ){.    
35b0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 6f 64  const char *zMod
35c0: 75 6c 65 20 3d 20 70 54 61 62 2d 3e 61 7a 4d 6f  ule = pTab->azMo
35d0: 64 75 6c 65 41 72 67 5b 30 5d 3b 0a 20 20 20 20  duleArg[0];.    
35e0: 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28  sqlite3ErrorMsg(
35f0: 70 50 61 72 73 65 2c 20 22 6e 6f 20 73 75 63 68  pParse, "no such
3600: 20 6d 6f 64 75 6c 65 3a 20 25 73 22 2c 20 7a 4d   module: %s", zM
3610: 6f 64 75 6c 65 29 3b 0a 20 20 20 20 72 63 20 3d  odule);.    rc =
3620: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
3630: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 63 68   } else {.    ch
3640: 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 20  ar *zErr = 0;.  
3650: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20    sqlite3 *db = 
3660: 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 20 20  pParse->db;.    
3670: 72 63 20 3d 20 76 74 61 62 43 61 6c 6c 43 6f 6e  rc = vtabCallCon
3680: 73 74 72 75 63 74 6f 72 28 64 62 2c 20 70 54 61  structor(db, pTa
3690: 62 2c 20 70 4d 6f 64 2c 20 70 4d 6f 64 2d 3e 70  b, pMod, pMod->p
36a0: 4d 6f 64 75 6c 65 2d 3e 78 43 6f 6e 6e 65 63 74  Module->xConnect
36b0: 2c 20 26 7a 45 72 72 29 3b 0a 20 20 20 20 69 66  , &zErr);.    if
36c0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
36d0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
36e0: 45 72 72 6f 72 4d 73 67 28 70 50 61 72 73 65 2c  ErrorMsg(pParse,
36f0: 20 22 25 73 22 2c 20 7a 45 72 72 29 3b 0a 20 20   "%s", zErr);.  
3700: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f    }.    sqlite3_
3710: 66 72 65 65 28 7a 45 72 72 29 3b 0a 20 20 7d 0a  free(zErr);.  }.
3720: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
3730: 0a 2f 2a 0a 2a 2a 20 41 64 64 20 74 68 65 20 76  ./*.** Add the v
3740: 69 72 74 75 61 6c 20 74 61 62 6c 65 20 70 56 74  irtual table pVt
3750: 61 62 20 74 6f 20 74 68 65 20 61 72 72 61 79 20  ab to the array 
3760: 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e 73 5b  sqlite3.aVTrans[
3770: 5d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  ]..*/.static int
3780: 20 61 64 64 54 6f 56 54 72 61 6e 73 28 73 71 6c   addToVTrans(sql
3790: 69 74 65 33 20 2a 64 62 2c 20 73 71 6c 69 74 65  ite3 *db, sqlite
37a0: 33 5f 76 74 61 62 20 2a 70 56 74 61 62 29 7b 0a  3_vtab *pVtab){.
37b0: 20 20 63 6f 6e 73 74 20 69 6e 74 20 41 52 52 41    const int ARRA
37c0: 59 5f 49 4e 43 52 20 3d 20 35 3b 0a 0a 20 20 2f  Y_INCR = 5;..  /
37d0: 2a 20 47 72 6f 77 20 74 68 65 20 73 71 6c 69 74  * Grow the sqlit
37e0: 65 33 2e 61 56 54 72 61 6e 73 20 61 72 72 61 79  e3.aVTrans array
37f0: 20 69 66 20 72 65 71 75 69 72 65 64 20 2a 2f 0a   if required */.
3800: 20 20 69 66 28 20 28 64 62 2d 3e 6e 56 54 72 61    if( (db->nVTra
3810: 6e 73 25 41 52 52 41 59 5f 49 4e 43 52 29 3d 3d  ns%ARRAY_INCR)==
3820: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
3830: 5f 76 74 61 62 20 2a 2a 61 56 54 72 61 6e 73 3b  _vtab **aVTrans;
3840: 0a 20 20 20 20 69 6e 74 20 6e 42 79 74 65 73 20  .    int nBytes 
3850: 3d 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33  = sizeof(sqlite3
3860: 5f 76 74 61 62 20 2a 29 20 2a 20 28 64 62 2d 3e  _vtab *) * (db->
3870: 6e 56 54 72 61 6e 73 20 2b 20 41 52 52 41 59 5f  nVTrans + ARRAY_
3880: 49 4e 43 52 29 3b 0a 20 20 20 20 61 56 54 72 61  INCR);.    aVTra
3890: 6e 73 20 3d 20 73 71 6c 69 74 65 33 44 62 52 65  ns = sqlite3DbRe
38a0: 61 6c 6c 6f 63 28 64 62 2c 20 28 76 6f 69 64 20  alloc(db, (void 
38b0: 2a 29 64 62 2d 3e 61 56 54 72 61 6e 73 2c 20 6e  *)db->aVTrans, n
38c0: 42 79 74 65 73 29 3b 0a 20 20 20 20 69 66 28 20  Bytes);.    if( 
38d0: 21 61 56 54 72 61 6e 73 20 29 7b 0a 20 20 20 20  !aVTrans ){.    
38e0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
38f0: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20  NOMEM;.    }.   
3900: 20 6d 65 6d 73 65 74 28 26 61 56 54 72 61 6e 73   memset(&aVTrans
3910: 5b 64 62 2d 3e 6e 56 54 72 61 6e 73 5d 2c 20 30  [db->nVTrans], 0
3920: 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33  , sizeof(sqlite3
3930: 5f 76 74 61 62 20 2a 29 2a 41 52 52 41 59 5f 49  _vtab *)*ARRAY_I
3940: 4e 43 52 29 3b 0a 20 20 20 20 64 62 2d 3e 61 56  NCR);.    db->aV
3950: 54 72 61 6e 73 20 3d 20 61 56 54 72 61 6e 73 3b  Trans = aVTrans;
3960: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 64 64 20 70  .  }..  /* Add p
3970: 56 74 61 62 20 74 6f 20 74 68 65 20 65 6e 64 20  Vtab to the end 
3980: 6f 66 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61  of sqlite3.aVTra
3990: 6e 73 20 2a 2f 0a 20 20 64 62 2d 3e 61 56 54 72  ns */.  db->aVTr
39a0: 61 6e 73 5b 64 62 2d 3e 6e 56 54 72 61 6e 73 2b  ans[db->nVTrans+
39b0: 2b 5d 20 3d 20 70 56 74 61 62 3b 0a 20 20 73 71  +] = pVtab;.  sq
39c0: 6c 69 74 65 33 56 74 61 62 4c 6f 63 6b 28 70 56  lite3VtabLock(pV
39d0: 74 61 62 29 3b 0a 20 20 72 65 74 75 72 6e 20 53  tab);.  return S
39e0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
39f0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
3a00: 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 74   is invoked by t
3a10: 68 65 20 76 64 62 65 20 74 6f 20 63 61 6c 6c 20  he vdbe to call 
3a20: 74 68 65 20 78 43 72 65 61 74 65 20 6d 65 74 68  the xCreate meth
3a30: 6f 64 0a 2a 2a 20 6f 66 20 74 68 65 20 76 69 72  od.** of the vir
3a40: 74 75 61 6c 20 74 61 62 6c 65 20 6e 61 6d 65 64  tual table named
3a50: 20 7a 54 61 62 20 69 6e 20 64 61 74 61 62 61 73   zTab in databas
3a60: 65 20 69 44 62 2e 20 0a 2a 2a 0a 2a 2a 20 49 66  e iDb. .**.** If
3a70: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
3a80: 2c 20 2a 70 7a 45 72 72 20 69 73 20 73 65 74 20  , *pzErr is set 
3a90: 74 6f 20 70 6f 69 6e 74 20 61 6e 20 61 6e 20 45  to point an an E
3aa0: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 0a  nglish language.
3ab0: 2a 2a 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f  ** description o
3ac0: 66 20 74 68 65 20 65 72 72 6f 72 20 61 6e 64 20  f the error and 
3ad0: 61 6e 20 53 51 4c 49 54 45 5f 58 58 58 20 65 72  an SQLITE_XXX er
3ae0: 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75  ror code is retu
3af0: 72 6e 65 64 2e 0a 2a 2a 20 49 6e 20 74 68 69 73  rned..** In this
3b00: 20 63 61 73 65 20 74 68 65 20 63 61 6c 6c 65 72   case the caller
3b10: 20 6d 75 73 74 20 63 61 6c 6c 20 73 71 6c 69 74   must call sqlit
3b20: 65 33 5f 66 72 65 65 28 29 20 6f 6e 20 2a 70 7a  e3_free() on *pz
3b30: 45 72 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  Err..*/.int sqli
3b40: 74 65 33 56 74 61 62 43 61 6c 6c 43 72 65 61 74  te3VtabCallCreat
3b50: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  e(sqlite3 *db, i
3b60: 6e 74 20 69 44 62 2c 20 63 6f 6e 73 74 20 63 68  nt iDb, const ch
3b70: 61 72 20 2a 7a 54 61 62 2c 20 63 68 61 72 20 2a  ar *zTab, char *
3b80: 2a 70 7a 45 72 72 29 7b 0a 20 20 69 6e 74 20 72  *pzErr){.  int r
3b90: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
3ba0: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
3bb0: 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 3b 0a 20 20  Module *pMod;.  
3bc0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 6f 64  const char *zMod
3bd0: 75 6c 65 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73  ule;..  pTab = s
3be0: 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28  qlite3FindTable(
3bf0: 64 62 2c 20 7a 54 61 62 2c 20 64 62 2d 3e 61 44  db, zTab, db->aD
3c00: 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 3b 0a 20  b[iDb].zName);. 
3c10: 20 61 73 73 65 72 74 28 70 54 61 62 20 26 26 20   assert(pTab && 
3c20: 70 54 61 62 2d 3e 69 73 56 69 72 74 75 61 6c 20  pTab->isVirtual 
3c30: 26 26 20 21 70 54 61 62 2d 3e 70 56 74 61 62 29  && !pTab->pVtab)
3c40: 3b 0a 20 20 70 4d 6f 64 20 3d 20 70 54 61 62 2d  ;.  pMod = pTab-
3c50: 3e 70 4d 6f 64 3b 0a 20 20 7a 4d 6f 64 75 6c 65  >pMod;.  zModule
3c60: 20 3d 20 70 54 61 62 2d 3e 61 7a 4d 6f 64 75 6c   = pTab->azModul
3c70: 65 41 72 67 5b 30 5d 3b 0a 0a 20 20 2f 2a 20 49  eArg[0];..  /* I
3c80: 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 68 61 73  f the module has
3c90: 20 62 65 65 6e 20 72 65 67 69 73 74 65 72 65 64   been registered
3ca0: 20 61 6e 64 20 69 6e 63 6c 75 64 65 73 20 61 20   and includes a 
3cb0: 43 72 65 61 74 65 20 6d 65 74 68 6f 64 2c 20 0a  Create method, .
3cc0: 20 20 2a 2a 20 69 6e 76 6f 6b 65 20 69 74 20 6e    ** invoke it n
3cd0: 6f 77 2e 20 49 66 20 74 68 65 20 6d 6f 64 75 6c  ow. If the modul
3ce0: 65 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 72  e has not been r
3cf0: 65 67 69 73 74 65 72 65 64 2c 20 72 65 74 75 72  egistered, retur
3d00: 6e 20 61 6e 20 0a 20 20 2a 2a 20 65 72 72 6f 72  n an .  ** error
3d10: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 64 6f 20  . Otherwise, do 
3d20: 6e 6f 74 68 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20  nothing..  */.  
3d30: 69 66 28 20 21 70 4d 6f 64 20 29 7b 0a 20 20 20  if( !pMod ){.   
3d40: 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74 65   *pzErr = sqlite
3d50: 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6e 6f  3MPrintf(db, "no
3d60: 20 73 75 63 68 20 6d 6f 64 75 6c 65 3a 20 25 73   such module: %s
3d70: 22 2c 20 7a 4d 6f 64 75 6c 65 29 3b 0a 20 20 20  ", zModule);.   
3d80: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
3d90: 4f 52 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  OR;.  }else{.   
3da0: 20 72 63 20 3d 20 76 74 61 62 43 61 6c 6c 43 6f   rc = vtabCallCo
3db0: 6e 73 74 72 75 63 74 6f 72 28 64 62 2c 20 70 54  nstructor(db, pT
3dc0: 61 62 2c 20 70 4d 6f 64 2c 20 70 4d 6f 64 2d 3e  ab, pMod, pMod->
3dd0: 70 4d 6f 64 75 6c 65 2d 3e 78 43 72 65 61 74 65  pModule->xCreate
3de0: 2c 20 70 7a 45 72 72 29 3b 0a 20 20 7d 0a 0a 20  , pzErr);.  }.. 
3df0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
3e00: 4f 4b 20 26 26 20 70 54 61 62 2d 3e 70 56 74 61  OK && pTab->pVta
3e10: 62 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  b ){.      rc = 
3e20: 61 64 64 54 6f 56 54 72 61 6e 73 28 64 62 2c 20  addToVTrans(db, 
3e30: 70 54 61 62 2d 3e 70 56 74 61 62 29 3b 0a 20 20  pTab->pVtab);.  
3e40: 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  }..  return rc;.
3e50: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  }../*.** This fu
3e60: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74  nction is used t
3e70: 6f 20 73 65 74 20 74 68 65 20 73 63 68 65 6d 61  o set the schema
3e80: 20 6f 66 20 61 20 76 69 72 74 75 61 6c 20 74 61   of a virtual ta
3e90: 62 6c 65 2e 20 20 49 74 20 69 73 20 6f 6e 6c 79  ble.  It is only
3ea0: 0a 2a 2a 20 76 61 6c 69 64 20 74 6f 20 63 61 6c  .** valid to cal
3eb0: 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  l this function 
3ec0: 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20  from within the 
3ed0: 78 43 72 65 61 74 65 28 29 20 6f 72 20 78 43 6f  xCreate() or xCo
3ee0: 6e 6e 65 63 74 28 29 20 6f 66 20 61 0a 2a 2a 20  nnect() of a.** 
3ef0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f  virtual table mo
3f00: 64 75 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  dule..*/.int sql
3f10: 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61  ite3_declare_vta
3f20: 62 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63  b(sqlite3 *db, c
3f30: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 72 65 61  onst char *zCrea
3f40: 74 65 54 61 62 6c 65 29 7b 0a 20 20 50 61 72 73  teTable){.  Pars
3f50: 65 20 73 50 61 72 73 65 3b 0a 0a 20 20 69 6e 74  e sParse;..  int
3f60: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
3f70: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a  .  Table *pTab;.
3f80: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30    char *zErr = 0
3f90: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  ;..  sqlite3_mut
3fa0: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74  ex_enter(db->mut
3fb0: 65 78 29 3b 0a 20 20 70 54 61 62 20 3d 20 64 62  ex);.  pTab = db
3fc0: 2d 3e 70 56 54 61 62 3b 0a 20 20 69 66 28 20 21  ->pVTab;.  if( !
3fd0: 70 54 61 62 20 29 7b 0a 20 20 20 20 73 71 6c 69  pTab ){.    sqli
3fe0: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
3ff0: 49 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a  ITE_MISUSE, 0);.
4000: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
4010: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65  x_leave(db->mute
4020: 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  x);.    return S
4030: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
4040: 7d 0a 20 20 61 73 73 65 72 74 28 70 54 61 62 2d  }.  assert(pTab-
4050: 3e 69 73 56 69 72 74 75 61 6c 20 26 26 20 70 54  >isVirtual && pT
4060: 61 62 2d 3e 6e 43 6f 6c 3d 3d 30 20 26 26 20 70  ab->nCol==0 && p
4070: 54 61 62 2d 3e 61 43 6f 6c 3d 3d 30 29 3b 0a 0a  Tab->aCol==0);..
4080: 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65    memset(&sParse
4090: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 50 61 72 73  , 0, sizeof(Pars
40a0: 65 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 65  e));.  sParse.de
40b0: 63 6c 61 72 65 56 74 61 62 20 3d 20 31 3b 0a 20  clareVtab = 1;. 
40c0: 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64 62 3b   sParse.db = db;
40d0: 0a 0a 20 20 69 66 28 20 0a 20 20 20 20 20 20 53  ..  if( .      S
40e0: 51 4c 49 54 45 5f 4f 4b 20 3d 3d 20 73 71 6c 69  QLITE_OK == sqli
40f0: 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73 50  te3RunParser(&sP
4100: 61 72 73 65 2c 20 7a 43 72 65 61 74 65 54 61 62  arse, zCreateTab
4110: 6c 65 2c 20 26 7a 45 72 72 29 20 26 26 20 0a 20  le, &zErr) && . 
4120: 20 20 20 20 20 73 50 61 72 73 65 2e 70 4e 65 77       sParse.pNew
4130: 54 61 62 6c 65 20 26 26 20 0a 20 20 20 20 20 20  Table && .      
4140: 21 73 50 61 72 73 65 2e 70 4e 65 77 54 61 62 6c  !sParse.pNewTabl
4150: 65 2d 3e 70 53 65 6c 65 63 74 20 26 26 20 0a 20  e->pSelect && . 
4160: 20 20 20 20 20 21 73 50 61 72 73 65 2e 70 4e 65       !sParse.pNe
4170: 77 54 61 62 6c 65 2d 3e 69 73 56 69 72 74 75 61  wTable->isVirtua
4180: 6c 20 0a 20 20 29 7b 0a 20 20 20 20 70 54 61 62  l .  ){.    pTab
4190: 2d 3e 61 43 6f 6c 20 3d 20 73 50 61 72 73 65 2e  ->aCol = sParse.
41a0: 70 4e 65 77 54 61 62 6c 65 2d 3e 61 43 6f 6c 3b  pNewTable->aCol;
41b0: 0a 20 20 20 20 70 54 61 62 2d 3e 6e 43 6f 6c 20  .    pTab->nCol 
41c0: 3d 20 73 50 61 72 73 65 2e 70 4e 65 77 54 61 62  = sParse.pNewTab
41d0: 6c 65 2d 3e 6e 43 6f 6c 3b 0a 20 20 20 20 73 50  le->nCol;.    sP
41e0: 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65 2d 3e  arse.pNewTable->
41f0: 6e 43 6f 6c 20 3d 20 30 3b 0a 20 20 20 20 73 50  nCol = 0;.    sP
4200: 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65 2d 3e  arse.pNewTable->
4210: 61 43 6f 6c 20 3d 20 30 3b 0a 20 20 20 20 64 62  aCol = 0;.    db
4220: 2d 3e 70 56 54 61 62 20 3d 20 30 3b 0a 20 20 7d  ->pVTab = 0;.  }
4230: 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 71 6c 69   else {.    sqli
4240: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
4250: 49 54 45 5f 45 52 52 4f 52 2c 20 7a 45 72 72 29  ITE_ERROR, zErr)
4260: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72  ;.    sqlite3_fr
4270: 65 65 28 7a 45 72 72 29 3b 0a 20 20 20 20 72 63  ee(zErr);.    rc
4280: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b   = SQLITE_ERROR;
4290: 0a 20 20 7d 0a 20 20 73 50 61 72 73 65 2e 64 65  .  }.  sParse.de
42a0: 63 6c 61 72 65 56 74 61 62 20 3d 20 30 3b 0a 0a  clareVtab = 0;..
42b0: 20 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69    sqlite3_finali
42c0: 7a 65 28 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ze((sqlite3_stmt
42d0: 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 29 3b  *)sParse.pVdbe);
42e0: 0a 20 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65  .  sqlite3Delete
42f0: 54 61 62 6c 65 28 73 50 61 72 73 65 2e 70 4e 65  Table(sParse.pNe
4300: 77 54 61 62 6c 65 29 3b 0a 20 20 73 50 61 72 73  wTable);.  sPars
4310: 65 2e 70 4e 65 77 54 61 62 6c 65 20 3d 20 30 3b  e.pNewTable = 0;
4320: 0a 0a 20 20 61 73 73 65 72 74 28 20 28 72 63 26  ..  assert( (rc&
4330: 30 78 66 66 29 3d 3d 72 63 20 29 3b 0a 20 20 72  0xff)==rc );.  r
4340: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
4350: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71  it(db, rc);.  sq
4360: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
4370: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  e(db->mutex);.  
4380: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
4390: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
43a0: 6e 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20  n is invoked by 
43b0: 74 68 65 20 76 64 62 65 20 74 6f 20 63 61 6c 6c  the vdbe to call
43c0: 20 74 68 65 20 78 44 65 73 74 72 6f 79 20 6d 65   the xDestroy me
43d0: 74 68 6f 64 0a 2a 2a 20 6f 66 20 74 68 65 20 76  thod.** of the v
43e0: 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6e 61 6d  irtual table nam
43f0: 65 64 20 7a 54 61 62 20 69 6e 20 64 61 74 61 62  ed zTab in datab
4400: 61 73 65 20 69 44 62 2e 20 54 68 69 73 20 6f 63  ase iDb. This oc
4410: 63 75 72 73 0a 2a 2a 20 77 68 65 6e 20 61 20 44  curs.** when a D
4420: 52 4f 50 20 54 41 42 4c 45 20 69 73 20 6d 65 6e  ROP TABLE is men
4430: 74 69 6f 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  tioned..**.** Th
4440: 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d  is call is a no-
4450: 6f 70 20 69 66 20 7a 54 61 62 20 69 73 20 6e 6f  op if zTab is no
4460: 74 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c  t a virtual tabl
4470: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
4480: 33 56 74 61 62 43 61 6c 6c 44 65 73 74 72 6f 79  3VtabCallDestroy
4490: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
44a0: 74 20 69 44 62 2c 20 63 6f 6e 73 74 20 63 68 61  t iDb, const cha
44b0: 72 20 2a 7a 54 61 62 29 0a 7b 0a 20 20 69 6e 74  r *zTab).{.  int
44c0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
44d0: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a  .  Table *pTab;.
44e0: 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65  .  pTab = sqlite
44f0: 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a  3FindTable(db, z
4500: 54 61 62 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62  Tab, db->aDb[iDb
4510: 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 61 73 73 65  ].zName);.  asse
4520: 72 74 28 70 54 61 62 29 3b 0a 20 20 69 66 28 20  rt(pTab);.  if( 
4530: 70 54 61 62 2d 3e 70 56 74 61 62 20 29 7b 0a 20  pTab->pVtab ){. 
4540: 20 20 20 69 6e 74 20 28 2a 78 44 65 73 74 72 6f     int (*xDestro
4550: 79 29 28 73 71 6c 69 74 65 33 5f 76 74 61 62 20  y)(sqlite3_vtab 
4560: 2a 70 56 54 61 62 29 20 3d 20 70 54 61 62 2d 3e  *pVTab) = pTab->
4570: 70 4d 6f 64 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78  pMod->pModule->x
4580: 44 65 73 74 72 6f 79 3b 0a 20 20 20 20 72 63 20  Destroy;.    rc 
4590: 3d 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f  = sqlite3SafetyO
45a0: 66 66 28 64 62 29 3b 0a 20 20 20 20 61 73 73 65  ff(db);.    asse
45b0: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  rt( rc==SQLITE_O
45c0: 4b 20 29 3b 0a 20 20 20 20 69 66 28 20 78 44 65  K );.    if( xDe
45d0: 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 20 72  stroy ){.      r
45e0: 63 20 3d 20 78 44 65 73 74 72 6f 79 28 70 54 61  c = xDestroy(pTa
45f0: 62 2d 3e 70 56 74 61 62 29 3b 0a 20 20 20 20 7d  b->pVtab);.    }
4600: 0a 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74  .    (void)sqlit
4610: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a  e3SafetyOn(db);.
4620: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
4630: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69  TE_OK ){.      i
4640: 6e 74 20 69 3b 0a 20 20 20 20 20 20 66 6f 72 28  nt i;.      for(
4650: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 56 54 72 61  i=0; i<db->nVTra
4660: 6e 73 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  ns; i++){.      
4670: 20 20 69 66 28 20 64 62 2d 3e 61 56 54 72 61 6e    if( db->aVTran
4680: 73 5b 69 5d 3d 3d 70 54 61 62 2d 3e 70 56 74 61  s[i]==pTab->pVta
4690: 62 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 64  b ){.          d
46a0: 62 2d 3e 61 56 54 72 61 6e 73 5b 69 5d 20 3d 20  b->aVTrans[i] = 
46b0: 64 62 2d 3e 61 56 54 72 61 6e 73 5b 2d 2d 64 62  db->aVTrans[--db
46c0: 2d 3e 6e 56 54 72 61 6e 73 5d 3b 0a 20 20 20 20  ->nVTrans];.    
46d0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
46e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
46f0: 20 20 20 20 20 70 54 61 62 2d 3e 70 56 74 61 62       pTab->pVtab
4700: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
4710: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
4720: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
4730: 74 69 6f 6e 20 69 6e 76 6f 6b 65 73 20 65 69 74  tion invokes eit
4740: 68 65 72 20 74 68 65 20 78 52 6f 6c 6c 62 61 63  her the xRollbac
4750: 6b 20 6f 72 20 78 43 6f 6d 6d 69 74 20 6d 65 74  k or xCommit met
4760: 68 6f 64 0a 2a 2a 20 6f 66 20 65 61 63 68 20 6f  hod.** of each o
4770: 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61  f the virtual ta
4780: 62 6c 65 73 20 69 6e 20 74 68 65 20 73 71 6c 69  bles in the sqli
4790: 74 65 33 2e 61 56 54 72 61 6e 73 20 61 72 72 61  te3.aVTrans arra
47a0: 79 2e 20 54 68 65 20 6d 65 74 68 6f 64 0a 2a 2a  y. The method.**
47b0: 20 63 61 6c 6c 65 64 20 69 73 20 69 64 65 6e 74   called is ident
47c0: 69 66 69 65 64 20 62 79 20 74 68 65 20 73 65 63  ified by the sec
47d0: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2c 20 22 6f  ond argument, "o
47e0: 66 66 73 65 74 22 2c 20 77 68 69 63 68 20 69 73  ffset", which is
47f0: 0a 2a 2a 20 74 68 65 20 6f 66 66 73 65 74 20 6f  .** the offset o
4800: 66 20 74 68 65 20 6d 65 74 68 6f 64 20 74 6f 20  f the method to 
4810: 63 61 6c 6c 20 69 6e 20 74 68 65 20 73 71 6c 69  call in the sqli
4820: 74 65 33 5f 6d 6f 64 75 6c 65 20 73 74 72 75 63  te3_module struc
4830: 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ture..**.** The 
4840: 61 72 72 61 79 20 69 73 20 63 6c 65 61 72 65 64  array is cleared
4850: 20 61 66 74 65 72 20 69 6e 76 6f 6b 69 6e 67 20   after invoking 
4860: 74 68 65 20 63 61 6c 6c 62 61 63 6b 73 2e 20 0a  the callbacks. .
4870: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63  */.static void c
4880: 61 6c 6c 46 69 6e 61 6c 69 73 65 72 28 73 71 6c  allFinaliser(sql
4890: 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6f 66  ite3 *db, int of
48a0: 66 73 65 74 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  fset){.  int i;.
48b0: 20 20 69 66 28 20 64 62 2d 3e 61 56 54 72 61 6e    if( db->aVTran
48c0: 73 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30  s ){.    for(i=0
48d0: 3b 20 69 3c 64 62 2d 3e 6e 56 54 72 61 6e 73 20  ; i<db->nVTrans 
48e0: 26 26 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b 69  && db->aVTrans[i
48f0: 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73  ]; i++){.      s
4900: 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74  qlite3_vtab *pVt
4910: 61 62 20 3d 20 64 62 2d 3e 61 56 54 72 61 6e 73  ab = db->aVTrans
4920: 5b 69 5d 3b 0a 20 20 20 20 20 20 69 6e 74 20 28  [i];.      int (
4930: 2a 78 29 28 73 71 6c 69 74 65 33 5f 76 74 61 62  *x)(sqlite3_vtab
4940: 20 2a 29 3b 0a 20 20 20 20 20 20 78 20 3d 20 2a   *);.      x = *
4950: 28 69 6e 74 20 28 2a 2a 29 28 73 71 6c 69 74 65  (int (**)(sqlite
4960: 33 5f 76 74 61 62 20 2a 29 29 28 28 63 68 61 72  3_vtab *))((char
4970: 20 2a 29 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c   *)pVtab->pModul
4980: 65 20 2b 20 6f 66 66 73 65 74 29 3b 0a 20 20 20  e + offset);.   
4990: 20 20 20 69 66 28 20 78 20 29 20 78 28 70 56 74     if( x ) x(pVt
49a0: 61 62 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  ab);.      sqlit
49b0: 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 64 62 2c  e3VtabUnlock(db,
49c0: 20 70 56 74 61 62 29 3b 0a 20 20 20 20 7d 0a 20   pVtab);.    }. 
49d0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
49e0: 64 62 2d 3e 61 56 54 72 61 6e 73 29 3b 0a 20 20  db->aVTrans);.  
49f0: 20 20 64 62 2d 3e 6e 56 54 72 61 6e 73 20 3d 20    db->nVTrans = 
4a00: 30 3b 0a 20 20 20 20 64 62 2d 3e 61 56 54 72 61  0;.    db->aVTra
4a10: 6e 73 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f  ns = 0;.  }.}../
4a20: 2a 0a 2a 2a 20 49 66 20 61 72 67 75 6d 65 6e 74  *.** If argument
4a30: 20 72 63 32 20 69 73 20 6e 6f 74 20 53 51 4c 49   rc2 is not SQLI
4a40: 54 45 5f 4f 4b 2c 20 74 68 65 6e 20 72 65 74 75  TE_OK, then retu
4a50: 72 6e 20 69 74 20 61 6e 64 20 64 6f 20 6e 6f 74  rn it and do not
4a60: 68 69 6e 67 2e 20 0a 2a 2a 20 4f 74 68 65 72 77  hing. .** Otherw
4a70: 69 73 65 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  ise, invoke the 
4a80: 78 53 79 6e 63 20 6d 65 74 68 6f 64 20 6f 66 20  xSync method of 
4a90: 61 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62 6c  all virtual tabl
4aa0: 65 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20 73 71  es in the .** sq
4ab0: 6c 69 74 65 33 2e 61 56 54 72 61 6e 73 20 61 72  lite3.aVTrans ar
4ac0: 72 61 79 2e 20 52 65 74 75 72 6e 20 74 68 65 20  ray. Return the 
4ad0: 65 72 72 6f 72 20 63 6f 64 65 20 66 6f 72 20 74  error code for t
4ae0: 68 65 20 66 69 72 73 74 20 65 72 72 6f 72 20 0a  he first error .
4af0: 2a 2a 20 74 68 61 74 20 6f 63 63 75 72 73 2c 20  ** that occurs, 
4b00: 6f 72 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20  or SQLITE_OK if 
4b10: 61 6c 6c 20 78 53 79 6e 63 20 6f 70 65 72 61 74  all xSync operat
4b20: 69 6f 6e 73 20 61 72 65 20 73 75 63 63 65 73 73  ions are success
4b30: 66 75 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ful..*/.int sqli
4b40: 74 65 33 56 74 61 62 53 79 6e 63 28 73 71 6c 69  te3VtabSync(sqli
4b50: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 72 63 32  te3 *db, int rc2
4b60: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  ){.  int i;.  in
4b70: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
4b80: 3b 0a 20 20 69 6e 74 20 72 63 73 61 66 65 74 79  ;.  int rcsafety
4b90: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62  ;.  sqlite3_vtab
4ba0: 20 2a 2a 61 56 54 72 61 6e 73 20 3d 20 64 62 2d   **aVTrans = db-
4bb0: 3e 61 56 54 72 61 6e 73 3b 0a 20 20 69 66 28 20  >aVTrans;.  if( 
4bc0: 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29  rc2!=SQLITE_OK )
4bd0: 20 72 65 74 75 72 6e 20 72 63 32 3b 0a 0a 20 20   return rc2;..  
4be0: 72 63 20 3d 20 73 71 6c 69 74 65 33 53 61 66 65  rc = sqlite3Safe
4bf0: 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 64 62 2d  tyOff(db);.  db-
4c00: 3e 61 56 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20  >aVTrans = 0;.  
4c10: 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c  for(i=0; rc==SQL
4c20: 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e  ITE_OK && i<db->
4c30: 6e 56 54 72 61 6e 73 20 26 26 20 61 56 54 72 61  nVTrans && aVTra
4c40: 6e 73 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20  ns[i]; i++){.   
4c50: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70   sqlite3_vtab *p
4c60: 56 74 61 62 20 3d 20 61 56 54 72 61 6e 73 5b 69  Vtab = aVTrans[i
4c70: 5d 3b 0a 20 20 20 20 69 6e 74 20 28 2a 78 29 28  ];.    int (*x)(
4c80: 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 29 3b  sqlite3_vtab *);
4c90: 0a 20 20 20 20 78 20 3d 20 70 56 74 61 62 2d 3e  .    x = pVtab->
4ca0: 70 4d 6f 64 75 6c 65 2d 3e 78 53 79 6e 63 3b 0a  pModule->xSync;.
4cb0: 20 20 20 20 69 66 28 20 78 20 29 7b 0a 20 20 20      if( x ){.   
4cc0: 20 20 20 72 63 20 3d 20 78 28 70 56 74 61 62 29     rc = x(pVtab)
4cd0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 64 62  ;.    }.  }.  db
4ce0: 2d 3e 61 56 54 72 61 6e 73 20 3d 20 61 56 54 72  ->aVTrans = aVTr
4cf0: 61 6e 73 3b 0a 20 20 72 63 73 61 66 65 74 79 20  ans;.  rcsafety 
4d00: 3d 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f  = sqlite3SafetyO
4d10: 6e 28 64 62 29 3b 0a 0a 20 20 69 66 28 20 72 63  n(db);..  if( rc
4d20: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
4d30: 20 20 20 72 63 20 3d 20 72 63 73 61 66 65 74 79     rc = rcsafety
4d40: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
4d50: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f  c;.}../*.** Invo
4d60: 6b 65 20 74 68 65 20 78 52 6f 6c 6c 62 61 63 6b  ke the xRollback
4d70: 20 6d 65 74 68 6f 64 20 6f 66 20 61 6c 6c 20 76   method of all v
4d80: 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e  irtual tables in
4d90: 20 74 68 65 20 0a 2a 2a 20 73 71 6c 69 74 65 33   the .** sqlite3
4da0: 2e 61 56 54 72 61 6e 73 20 61 72 72 61 79 2e 20  .aVTrans array. 
4db0: 54 68 65 6e 20 63 6c 65 61 72 20 74 68 65 20 61  Then clear the a
4dc0: 72 72 61 79 20 69 74 73 65 6c 66 2e 0a 2a 2f 0a  rray itself..*/.
4dd0: 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 52  int sqlite3VtabR
4de0: 6f 6c 6c 62 61 63 6b 28 73 71 6c 69 74 65 33 20  ollback(sqlite3 
4df0: 2a 64 62 29 7b 0a 20 20 63 61 6c 6c 46 69 6e 61  *db){.  callFina
4e00: 6c 69 73 65 72 28 64 62 2c 20 6f 66 66 73 65 74  liser(db, offset
4e10: 6f 66 28 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c  of(sqlite3_modul
4e20: 65 2c 78 52 6f 6c 6c 62 61 63 6b 29 29 3b 0a 20  e,xRollback));. 
4e30: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
4e40: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f  K;.}../*.** Invo
4e50: 6b 65 20 74 68 65 20 78 43 6f 6d 6d 69 74 20 6d  ke the xCommit m
4e60: 65 74 68 6f 64 20 6f 66 20 61 6c 6c 20 76 69 72  ethod of all vir
4e70: 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 20 74  tual tables in t
4e80: 68 65 20 0a 2a 2a 20 73 71 6c 69 74 65 33 2e 61  he .** sqlite3.a
4e90: 56 54 72 61 6e 73 20 61 72 72 61 79 2e 20 54 68  VTrans array. Th
4ea0: 65 6e 20 63 6c 65 61 72 20 74 68 65 20 61 72 72  en clear the arr
4eb0: 61 79 20 69 74 73 65 6c 66 2e 0a 2a 2f 0a 69 6e  ay itself..*/.in
4ec0: 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f 6d  t sqlite3VtabCom
4ed0: 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29  mit(sqlite3 *db)
4ee0: 7b 0a 20 20 63 61 6c 6c 46 69 6e 61 6c 69 73 65  {.  callFinalise
4ef0: 72 28 64 62 2c 20 6f 66 66 73 65 74 6f 66 28 73  r(db, offsetof(s
4f00: 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 2c 78 43  qlite3_module,xC
4f10: 6f 6d 6d 69 74 29 29 3b 0a 20 20 72 65 74 75 72  ommit));.  retur
4f20: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
4f30: 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 76 69 72  /*.** If the vir
4f40: 74 75 61 6c 20 74 61 62 6c 65 20 70 56 74 61 62  tual table pVtab
4f50: 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 74 72   supports the tr
4f60: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 65 72 66  ansaction interf
4f70: 61 63 65 0a 2a 2a 20 28 78 42 65 67 69 6e 2f 78  ace.** (xBegin/x
4f80: 52 6f 6c 6c 62 61 63 6b 2f 78 43 6f 6d 6d 69 74  Rollback/xCommit
4f90: 20 61 6e 64 20 6f 70 74 69 6f 6e 61 6c 6c 79 20   and optionally 
4fa0: 78 53 79 6e 63 29 20 61 6e 64 20 61 20 74 72 61  xSync) and a tra
4fb0: 6e 73 61 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 6e  nsaction is.** n
4fc0: 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 70 65  ot currently ope
4fd0: 6e 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 78 42  n, invoke the xB
4fe0: 65 67 69 6e 20 6d 65 74 68 6f 64 20 6e 6f 77 2e  egin method now.
4ff0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 78 42  .**.** If the xB
5000: 65 67 69 6e 20 63 61 6c 6c 20 69 73 20 73 75 63  egin call is suc
5010: 63 65 73 73 66 75 6c 2c 20 70 6c 61 63 65 20 74  cessful, place t
5020: 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20  he sqlite3_vtab 
5030: 70 6f 69 6e 74 65 72 0a 2a 2a 20 69 6e 20 74 68  pointer.** in th
5040: 65 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e  e sqlite3.aVTran
5050: 73 20 61 72 72 61 79 2e 0a 2a 2f 0a 69 6e 74 20  s array..*/.int 
5060: 73 71 6c 69 74 65 33 56 74 61 62 42 65 67 69 6e  sqlite3VtabBegin
5070: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 73 71  (sqlite3 *db, sq
5080: 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61  lite3_vtab *pVta
5090: 62 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  b){.  int rc = S
50a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 6f 6e 73  QLITE_OK;.  cons
50b0: 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65  t sqlite3_module
50c0: 20 2a 70 4d 6f 64 75 6c 65 3b 0a 0a 20 20 2f 2a   *pModule;..  /*
50d0: 20 53 70 65 63 69 61 6c 20 63 61 73 65 3a 20 49   Special case: I
50e0: 66 20 64 62 2d 3e 61 56 54 72 61 6e 73 20 69 73  f db->aVTrans is
50f0: 20 4e 55 4c 4c 20 61 6e 64 20 64 62 2d 3e 6e 56   NULL and db->nV
5100: 54 72 61 6e 73 20 69 73 20 67 72 65 61 74 65 72  Trans is greater
5110: 0a 20 20 2a 2a 20 74 68 61 6e 20 7a 65 72 6f 2c  .  ** than zero,
5120: 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74   then this funct
5130: 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 63 61 6c  ion is being cal
5140: 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 20  led from within 
5150: 61 0a 20 20 2a 2a 20 76 69 72 74 75 61 6c 20 6d  a.  ** virtual m
5160: 6f 64 75 6c 65 20 78 53 79 6e 63 28 29 20 63 61  odule xSync() ca
5170: 6c 6c 62 61 63 6b 2e 20 49 74 20 69 73 20 69 6c  llback. It is il
5180: 6c 65 67 61 6c 20 74 6f 20 77 72 69 74 65 20 74  legal to write t
5190: 6f 20 0a 20 20 2a 2a 20 76 69 72 74 75 61 6c 20  o .  ** virtual 
51a0: 6d 6f 64 75 6c 65 20 74 61 62 6c 65 73 20 69 6e  module tables in
51b0: 20 74 68 69 73 20 63 61 73 65 2c 20 73 6f 20 72   this case, so r
51c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43  eturn SQLITE_LOC
51d0: 4b 45 44 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  KED..  */.  if( 
51e0: 30 3d 3d 64 62 2d 3e 61 56 54 72 61 6e 73 20 26  0==db->aVTrans &
51f0: 26 20 64 62 2d 3e 6e 56 54 72 61 6e 73 3e 30 20  & db->nVTrans>0 
5200: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
5210: 4c 49 54 45 5f 4c 4f 43 4b 45 44 3b 0a 20 20 7d  LITE_LOCKED;.  }
5220: 0a 20 20 69 66 28 20 21 70 56 74 61 62 20 29 7b  .  if( !pVtab ){
5230: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
5240: 54 45 5f 4f 4b 3b 0a 20 20 7d 20 0a 20 20 70 4d  TE_OK;.  } .  pM
5250: 6f 64 75 6c 65 20 3d 20 70 56 74 61 62 2d 3e 70  odule = pVtab->p
5260: 4d 6f 64 75 6c 65 3b 0a 0a 20 20 69 66 28 20 70  Module;..  if( p
5270: 4d 6f 64 75 6c 65 2d 3e 78 42 65 67 69 6e 20 29  Module->xBegin )
5280: 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 0a 0a 20  {.    int i;... 
5290: 20 20 20 2f 2a 20 49 66 20 70 56 74 61 62 20 69     /* If pVtab i
52a0: 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65  s already in the
52b0: 20 61 56 54 72 61 6e 73 20 61 72 72 61 79 2c 20   aVTrans array, 
52c0: 72 65 74 75 72 6e 20 65 61 72 6c 79 20 2a 2f 0a  return early */.
52d0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 28 69 3c      for(i=0; (i<
52e0: 64 62 2d 3e 6e 56 54 72 61 6e 73 29 20 26 26 20  db->nVTrans) && 
52f0: 30 21 3d 64 62 2d 3e 61 56 54 72 61 6e 73 5b 69  0!=db->aVTrans[i
5300: 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69  ]; i++){.      i
5310: 66 28 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b 69  f( db->aVTrans[i
5320: 5d 3d 3d 70 56 74 61 62 20 29 7b 0a 20 20 20 20  ]==pVtab ){.    
5330: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
5340: 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20  E_OK;.      }.  
5350: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 6e 76 6f    }..    /* Invo
5360: 6b 65 20 74 68 65 20 78 42 65 67 69 6e 20 6d 65  ke the xBegin me
5370: 74 68 6f 64 20 2a 2f 0a 20 20 20 20 72 63 20 3d  thod */.    rc =
5380: 20 70 4d 6f 64 75 6c 65 2d 3e 78 42 65 67 69 6e   pModule->xBegin
5390: 28 70 56 74 61 62 29 3b 0a 20 20 20 20 69 66 28  (pVtab);.    if(
53a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
53b0: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  {.      return r
53c0: 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 72 63  c;.    }..    rc
53d0: 20 3d 20 61 64 64 54 6f 56 54 72 61 6e 73 28 64   = addToVTrans(d
53e0: 62 2c 20 70 56 74 61 62 29 3b 0a 20 20 7d 0a 20  b, pVtab);.  }. 
53f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
5400: 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 70  *.** The first p
5410: 61 72 61 6d 65 74 65 72 20 28 70 44 65 66 29 20  arameter (pDef) 
5420: 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 6d  is a function im
5430: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54  plementation.  T
5440: 68 65 0a 2a 2a 20 73 65 63 6f 6e 64 20 70 61 72  he.** second par
5450: 61 6d 65 74 65 72 20 28 70 45 78 70 72 29 20 69  ameter (pExpr) i
5460: 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  s the first argu
5470: 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e  ment to this fun
5480: 63 74 69 6f 6e 2e 0a 2a 2a 20 49 66 20 70 45 78  ction..** If pEx
5490: 70 72 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 69  pr is a column i
54a0: 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c  n a virtual tabl
54b0: 65 2c 20 74 68 65 6e 20 6c 65 74 20 74 68 65 20  e, then let the 
54c0: 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65  virtual.** table
54d0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
54e0: 68 61 76 65 20 61 6e 20 6f 70 70 6f 72 74 75 6e  have an opportun
54f0: 69 74 79 20 74 6f 20 6f 76 65 72 6c 6f 61 64 20  ity to overload 
5500: 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a  the function..**
5510: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
5520: 20 69 73 20 75 73 65 64 20 74 6f 20 61 6c 6c 6f   is used to allo
5530: 77 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20  w virtual table 
5540: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20  implementations 
5550: 74 6f 0a 2a 2a 20 6f 76 65 72 6c 6f 61 64 20 4d  to.** overload M
5560: 41 54 43 48 2c 20 4c 49 4b 45 2c 20 47 4c 4f 42  ATCH, LIKE, GLOB
5570: 2c 20 61 6e 64 20 52 45 47 45 58 50 20 6f 70 65  , and REGEXP ope
5580: 72 61 74 6f 72 73 2e 0a 2a 2a 0a 2a 2a 20 52 65  rators..**.** Re
5590: 74 75 72 6e 20 65 69 74 68 65 72 20 74 68 65 20  turn either the 
55a0: 70 44 65 66 20 61 72 67 75 6d 65 6e 74 20 28 69  pDef argument (i
55b0: 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 63 68 61  ndicating no cha
55c0: 6e 67 65 29 20 6f 72 20 61 20 0a 2a 2a 20 6e 65  nge) or a .** ne
55d0: 77 20 46 75 6e 63 44 65 66 20 73 74 72 75 63 74  w FuncDef struct
55e0: 75 72 65 20 74 68 61 74 20 69 73 20 6d 61 72 6b  ure that is mark
55f0: 65 64 20 61 73 20 65 70 68 65 6d 65 72 61 6c 20  ed as ephemeral 
5600: 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 53 51 4c  using the.** SQL
5610: 49 54 45 5f 46 55 4e 43 5f 45 50 48 45 4d 20 66  ITE_FUNC_EPHEM f
5620: 6c 61 67 2e 0a 2a 2f 0a 46 75 6e 63 44 65 66 20  lag..*/.FuncDef 
5630: 2a 73 71 6c 69 74 65 33 56 74 61 62 4f 76 65 72  *sqlite3VtabOver
5640: 6c 6f 61 64 46 75 6e 63 74 69 6f 6e 28 0a 20 20  loadFunction(.  
5650: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
5660: 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e  /* Database conn
5670: 65 63 74 69 6f 6e 20 66 6f 72 20 72 65 70 6f 72  ection for repor
5680: 74 69 6e 67 20 6d 61 6c 6c 6f 63 20 70 72 6f 62  ting malloc prob
5690: 6c 65 6d 73 20 2a 2f 0a 20 20 46 75 6e 63 44 65  lems */.  FuncDe
56a0: 66 20 2a 70 44 65 66 2c 20 20 2f 2a 20 46 75 6e  f *pDef,  /* Fun
56b0: 63 74 69 6f 6e 20 74 6f 20 70 6f 73 73 69 62 6c  ction to possibl
56c0: 79 20 6f 76 65 72 6c 6f 61 64 20 2a 2f 0a 20 20  y overload */.  
56d0: 69 6e 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20  int nArg,       
56e0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67  /* Number of arg
56f0: 75 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 66 75  uments to the fu
5700: 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 45 78 70 72  nction */.  Expr
5710: 20 2a 70 45 78 70 72 20 20 20 20 20 2f 2a 20 46   *pExpr     /* F
5720: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f  irst argument to
5730: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f   the function */
5740: 0a 29 7b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61  .){.  Table *pTa
5750: 62 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61  b;.  sqlite3_vta
5760: 62 20 2a 70 56 74 61 62 3b 0a 20 20 73 71 6c 69  b *pVtab;.  sqli
5770: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64  te3_module *pMod
5780: 3b 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63  ;.  void (*xFunc
5790: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  )(sqlite3_contex
57a0: 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76  t*,int,sqlite3_v
57b0: 61 6c 75 65 2a 2a 29 3b 0a 20 20 76 6f 69 64 20  alue**);.  void 
57c0: 2a 70 41 72 67 3b 0a 20 20 46 75 6e 63 44 65 66  *pArg;.  FuncDef
57d0: 20 2a 70 4e 65 77 3b 0a 20 20 69 6e 74 20 72 63   *pNew;.  int rc
57e0: 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 2a 7a 4c   = 0;.  char *zL
57f0: 6f 77 65 72 4e 61 6d 65 3b 0a 20 20 75 6e 73 69  owerName;.  unsi
5800: 67 6e 65 64 20 63 68 61 72 20 2a 7a 3b 0a 0a 0a  gned char *z;...
5810: 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20 73 65    /* Check to se
5820: 65 20 74 68 65 20 6c 65 66 74 20 6f 70 65 72 61  e the left opera
5830: 6e 64 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 69  nd is a column i
5840: 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c  n a virtual tabl
5850: 65 20 2a 2f 0a 20 20 69 66 28 20 70 45 78 70 72  e */.  if( pExpr
5860: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 70 44 65  ==0 ) return pDe
5870: 66 3b 0a 20 20 69 66 28 20 70 45 78 70 72 2d 3e  f;.  if( pExpr->
5880: 6f 70 21 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 29 20  op!=TK_COLUMN ) 
5890: 72 65 74 75 72 6e 20 70 44 65 66 3b 0a 20 20 70  return pDef;.  p
58a0: 54 61 62 20 3d 20 70 45 78 70 72 2d 3e 70 54 61  Tab = pExpr->pTa
58b0: 62 3b 0a 20 20 69 66 28 20 70 54 61 62 3d 3d 30  b;.  if( pTab==0
58c0: 20 29 20 72 65 74 75 72 6e 20 70 44 65 66 3b 0a   ) return pDef;.
58d0: 20 20 69 66 28 20 21 70 54 61 62 2d 3e 69 73 56    if( !pTab->isV
58e0: 69 72 74 75 61 6c 20 29 20 72 65 74 75 72 6e 20  irtual ) return 
58f0: 70 44 65 66 3b 0a 20 20 70 56 74 61 62 20 3d 20  pDef;.  pVtab = 
5900: 70 54 61 62 2d 3e 70 56 74 61 62 3b 0a 20 20 61  pTab->pVtab;.  a
5910: 73 73 65 72 74 28 20 70 56 74 61 62 21 3d 30 20  ssert( pVtab!=0 
5920: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 74  );.  assert( pVt
5930: 61 62 2d 3e 70 4d 6f 64 75 6c 65 21 3d 30 20 29  ab->pModule!=0 )
5940: 3b 0a 20 20 70 4d 6f 64 20 3d 20 28 73 71 6c 69  ;.  pMod = (sqli
5950: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 29 70 56 74  te3_module *)pVt
5960: 61 62 2d 3e 70 4d 6f 64 75 6c 65 3b 0a 20 20 69  ab->pModule;.  i
5970: 66 28 20 70 4d 6f 64 2d 3e 78 46 69 6e 64 46 75  f( pMod->xFindFu
5980: 6e 63 74 69 6f 6e 3d 3d 30 20 29 20 72 65 74 75  nction==0 ) retu
5990: 72 6e 20 70 44 65 66 3b 0a 20 0a 20 20 2f 2a 20  rn pDef;. .  /* 
59a0: 43 61 6c 6c 20 74 68 65 20 78 46 69 6e 64 46 75  Call the xFindFu
59b0: 6e 63 74 69 6f 6e 20 6d 65 74 68 6f 64 20 6f 6e  nction method on
59c0: 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62   the virtual tab
59d0: 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  le implementatio
59e0: 6e 0a 20 20 2a 2a 20 74 6f 20 73 65 65 20 69 66  n.  ** to see if
59f0: 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   the implementat
5a00: 69 6f 6e 20 77 61 6e 74 73 20 74 6f 20 6f 76 65  ion wants to ove
5a10: 72 6c 6f 61 64 20 74 68 69 73 20 66 75 6e 63 74  rload this funct
5a20: 69 6f 6e 20 0a 20 20 2a 2f 0a 20 20 7a 4c 6f 77  ion .  */.  zLow
5a30: 65 72 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33  erName = sqlite3
5a40: 44 62 53 74 72 44 75 70 28 64 62 2c 20 70 44 65  DbStrDup(db, pDe
5a50: 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28  f->zName);.  if(
5a60: 20 7a 4c 6f 77 65 72 4e 61 6d 65 20 29 7b 0a 20   zLowerName ){. 
5a70: 20 20 20 66 6f 72 28 7a 3d 28 75 6e 73 69 67 6e     for(z=(unsign
5a80: 65 64 20 63 68 61 72 2a 29 7a 4c 6f 77 65 72 4e  ed char*)zLowerN
5a90: 61 6d 65 3b 20 2a 7a 3b 20 7a 2b 2b 29 7b 0a 20  ame; *z; z++){. 
5aa0: 20 20 20 20 20 2a 7a 20 3d 20 73 71 6c 69 74 65       *z = sqlite
5ab0: 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 2a 7a  3UpperToLower[*z
5ac0: 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20  ];.    }.    rc 
5ad0: 3d 20 70 4d 6f 64 2d 3e 78 46 69 6e 64 46 75 6e  = pMod->xFindFun
5ae0: 63 74 69 6f 6e 28 70 56 74 61 62 2c 20 6e 41 72  ction(pVtab, nAr
5af0: 67 2c 20 7a 4c 6f 77 65 72 4e 61 6d 65 2c 20 26  g, zLowerName, &
5b00: 78 46 75 6e 63 2c 20 26 70 41 72 67 29 3b 0a 20  xFunc, &pArg);. 
5b10: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
5b20: 7a 4c 6f 77 65 72 4e 61 6d 65 29 3b 0a 20 20 7d  zLowerName);.  }
5b30: 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a  .  if( rc==0 ){.
5b40: 20 20 20 20 72 65 74 75 72 6e 20 70 44 65 66 3b      return pDef;
5b50: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65 61 74  .  }..  /* Creat
5b60: 65 20 61 20 6e 65 77 20 65 70 68 65 6d 65 72 61  e a new ephemera
5b70: 6c 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e  l function defin
5b80: 69 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6f 76  ition for the ov
5b90: 65 72 6c 6f 61 64 65 64 0a 20 20 2a 2a 20 66 75  erloaded.  ** fu
5ba0: 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 70 4e 65 77  nction */.  pNew
5bb0: 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   = sqlite3DbMall
5bc0: 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 6f  ocZero(db, sizeo
5bd0: 66 28 2a 70 4e 65 77 29 20 2b 20 73 74 72 6c 65  f(*pNew) + strle
5be0: 6e 28 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 20 29  n(pDef->zName) )
5bf0: 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20  ;.  if( pNew==0 
5c00: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 44  ){.    return pD
5c10: 65 66 3b 0a 20 20 7d 0a 20 20 2a 70 4e 65 77 20  ef;.  }.  *pNew 
5c20: 3d 20 2a 70 44 65 66 3b 0a 20 20 6d 65 6d 63 70  = *pDef;.  memcp
5c30: 79 28 70 4e 65 77 2d 3e 7a 4e 61 6d 65 2c 20 70  y(pNew->zName, p
5c40: 44 65 66 2d 3e 7a 4e 61 6d 65 2c 20 73 74 72 6c  Def->zName, strl
5c50: 65 6e 28 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 2b  en(pDef->zName)+
5c60: 31 29 3b 0a 20 20 70 4e 65 77 2d 3e 78 46 75 6e  1);.  pNew->xFun
5c70: 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 4e 65  c = xFunc;.  pNe
5c80: 77 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70  w->pUserData = p
5c90: 41 72 67 3b 0a 20 20 70 4e 65 77 2d 3e 66 6c 61  Arg;.  pNew->fla
5ca0: 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 46 55 4e  gs |= SQLITE_FUN
5cb0: 43 5f 45 50 48 45 4d 3b 0a 20 20 72 65 74 75 72  C_EPHEM;.  retur
5cc0: 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  n pNew;.}../*.**
5cd0: 20 4d 61 6b 65 20 73 75 72 65 20 76 69 72 74 75   Make sure virtu
5ce0: 61 6c 20 74 61 62 6c 65 20 70 54 61 62 20 69 73  al table pTab is
5cf0: 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 68   contained in th
5d00: 65 20 70 50 61 72 73 65 2d 3e 61 70 56 69 72 74  e pParse->apVirt
5d10: 75 61 6c 4c 6f 63 6b 5b 5d 0a 2a 2a 20 61 72 72  ualLock[].** arr
5d20: 61 79 20 73 6f 20 74 68 61 74 20 61 6e 20 4f 50  ay so that an OP
5d30: 5f 56 42 65 67 69 6e 20 77 69 6c 6c 20 67 65 74  _VBegin will get
5d40: 20 67 65 6e 65 72 61 74 65 64 20 66 6f 72 20 69   generated for i
5d50: 74 2e 20 20 41 64 64 20 70 54 61 62 20 74 6f 20  t.  Add pTab to 
5d60: 74 68 65 0a 2a 2a 20 61 72 72 61 79 20 69 66 20  the.** array if 
5d70: 69 74 20 69 73 20 6d 69 73 73 69 6e 67 2e 20 20  it is missing.  
5d80: 49 66 20 70 54 61 62 20 69 73 20 61 6c 72 65 61  If pTab is alrea
5d90: 64 79 20 69 6e 20 74 68 65 20 61 72 72 61 79 2c  dy in the array,
5da0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a   this routine.**
5db0: 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a   is a no-op..*/.
5dc0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62  void sqlite3Vtab
5dd0: 4d 61 6b 65 57 72 69 74 61 62 6c 65 28 50 61 72  MakeWritable(Par
5de0: 73 65 20 2a 70 50 61 72 73 65 2c 20 54 61 62 6c  se *pParse, Tabl
5df0: 65 20 2a 70 54 61 62 29 7b 0a 20 20 69 6e 74 20  e *pTab){.  int 
5e00: 69 2c 20 6e 3b 0a 20 20 61 73 73 65 72 74 28 20  i, n;.  assert( 
5e10: 49 73 56 69 72 74 75 61 6c 28 70 54 61 62 29 20  IsVirtual(pTab) 
5e20: 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  );.  for(i=0; i<
5e30: 70 50 61 72 73 65 2d 3e 6e 56 74 61 62 4c 6f 63  pParse->nVtabLoc
5e40: 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  k; i++){.    if(
5e50: 20 70 54 61 62 3d 3d 70 50 61 72 73 65 2d 3e 61   pTab==pParse->a
5e60: 70 56 74 61 62 4c 6f 63 6b 5b 69 5d 20 29 20 72  pVtabLock[i] ) r
5e70: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 6e 20 3d  eturn;.  }.  n =
5e80: 20 28 70 50 61 72 73 65 2d 3e 6e 56 74 61 62 4c   (pParse->nVtabL
5e90: 6f 63 6b 2b 31 29 2a 73 69 7a 65 6f 66 28 70 50  ock+1)*sizeof(pP
5ea0: 61 72 73 65 2d 3e 61 70 56 74 61 62 4c 6f 63 6b  arse->apVtabLock
5eb0: 5b 30 5d 29 3b 0a 20 20 70 50 61 72 73 65 2d 3e  [0]);.  pParse->
5ec0: 61 70 56 74 61 62 4c 6f 63 6b 20 3d 20 73 71 6c  apVtabLock = sql
5ed0: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 70 50 61  ite3_realloc(pPa
5ee0: 72 73 65 2d 3e 61 70 56 74 61 62 4c 6f 63 6b 2c  rse->apVtabLock,
5ef0: 20 6e 29 3b 0a 20 20 69 66 28 20 70 50 61 72 73   n);.  if( pPars
5f00: 65 2d 3e 61 70 56 74 61 62 4c 6f 63 6b 20 29 7b  e->apVtabLock ){
5f10: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 61 70 56  .    pParse->apV
5f20: 74 61 62 4c 6f 63 6b 5b 70 50 61 72 73 65 2d 3e  tabLock[pParse->
5f30: 6e 56 74 61 62 4c 6f 63 6b 2b 2b 5d 20 3d 20 70  nVtabLock++] = p
5f40: 54 61 62 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  Tab;.  }else{.  
5f50: 20 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 6d 61    pParse->db->ma
5f60: 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a  llocFailed = 1;.
5f70: 20 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a    }.}..#endif /*
5f80: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52   SQLITE_OMIT_VIR
5f90: 54 55 41 4c 54 41 42 4c 45 20 2a 2f 0a           TUALTABLE */.