/ Hex Artifact Content
Login

Artifact ace9b41a088f6ad55d2e39084d92180a2bee3276:


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 35 36 20 32 30 30  tab.c,v 1.56 200
01d0: 37 2f 30 38 2f 32 39 20 31 34 3a 30 36 3a 32 33  7/08/29 14:06:23
01e0: 20 64 61 6e 69 65 6c 6b 31 39 37 37 20 45 78 70   danielk1977 Exp
01f0: 20 24 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51   $.*/.#ifndef SQ
0200: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41  LITE_OMIT_VIRTUA
0210: 4c 54 41 42 4c 45 0a 23 69 6e 63 6c 75 64 65 20  LTABLE.#include 
0220: 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 73  "sqliteInt.h"..s
0230: 74 61 74 69 63 20 69 6e 74 20 63 72 65 61 74 65  tatic int create
0240: 4d 6f 64 75 6c 65 28 0a 20 20 73 71 6c 69 74 65  Module(.  sqlite
0250: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
0260: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
0270: 61 62 61 73 65 20 69 6e 20 77 68 69 63 68 20 6d  abase in which m
0280: 6f 64 75 6c 65 20 69 73 20 72 65 67 69 73 74 65  odule is registe
0290: 72 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  red */.  const c
02a0: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 20 20  har *zName,     
02b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65           /* Name
02c0: 20 61 73 73 69 67 6e 65 64 20 74 6f 20 74 68 69   assigned to thi
02d0: 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a 20 20 63 6f  s module */.  co
02e0: 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75  nst sqlite3_modu
02f0: 6c 65 20 2a 70 4d 6f 64 75 6c 65 2c 20 20 2f 2a  le *pModule,  /*
0300: 20 54 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20   The definition 
0310: 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f  of the module */
0320: 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 20 20  .  void *pAux,  
0330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0340: 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 70 6f     /* Context po
0350: 69 6e 74 65 72 20 66 6f 72 20 78 43 72 65 61 74  inter for xCreat
0360: 65 2f 78 43 6f 6e 6e 65 63 74 20 2a 2f 0a 20 20  e/xConnect */.  
0370: 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29  void (*xDestroy)
0380: 28 76 6f 69 64 20 2a 29 20 20 20 20 20 20 20 20  (void *)        
0390: 2f 2a 20 4d 6f 64 75 6c 65 20 64 65 73 74 72 75  /* Module destru
03a0: 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f  ctor function */
03b0: 0a 29 20 7b 0a 20 20 69 6e 74 20 72 63 2c 20 6e  .) {.  int rc, n
03c0: 4e 61 6d 65 3b 0a 20 20 4d 6f 64 75 6c 65 20 2a  Name;.  Module *
03d0: 70 4d 6f 64 3b 0a 0a 20 20 73 71 6c 69 74 65 33  pMod;..  sqlite3
03e0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d  _mutex_enter(db-
03f0: 3e 6d 75 74 65 78 29 3b 0a 20 20 6e 4e 61 6d 65  >mutex);.  nName
0400: 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29   = strlen(zName)
0410: 3b 0a 20 20 70 4d 6f 64 20 3d 20 28 4d 6f 64 75  ;.  pMod = (Modu
0420: 6c 65 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61  le *)sqlite3DbMa
0430: 6c 6c 6f 63 52 61 77 28 64 62 2c 20 73 69 7a 65  llocRaw(db, size
0440: 6f 66 28 4d 6f 64 75 6c 65 29 20 2b 20 6e 4e 61  of(Module) + nNa
0450: 6d 65 20 2b 20 31 29 3b 0a 20 20 69 66 28 20 70  me + 1);.  if( p
0460: 4d 6f 64 20 29 7b 0a 20 20 20 20 63 68 61 72 20  Mod ){.    char 
0470: 2a 7a 43 6f 70 79 20 3d 20 28 63 68 61 72 20 2a  *zCopy = (char *
0480: 29 28 26 70 4d 6f 64 5b 31 5d 29 3b 0a 20 20 20  )(&pMod[1]);.   
0490: 20 6d 65 6d 63 70 79 28 7a 43 6f 70 79 2c 20 7a   memcpy(zCopy, z
04a0: 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2b 31 29 3b 0a  Name, nName+1);.
04b0: 20 20 20 20 70 4d 6f 64 2d 3e 7a 4e 61 6d 65 20      pMod->zName 
04c0: 3d 20 7a 43 6f 70 79 3b 0a 20 20 20 20 70 4d 6f  = zCopy;.    pMo
04d0: 64 2d 3e 70 4d 6f 64 75 6c 65 20 3d 20 70 4d 6f  d->pModule = pMo
04e0: 64 75 6c 65 3b 0a 20 20 20 20 70 4d 6f 64 2d 3e  dule;.    pMod->
04f0: 70 41 75 78 20 3d 20 70 41 75 78 3b 0a 20 20 20  pAux = pAux;.   
0500: 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 20   pMod->xDestroy 
0510: 3d 20 78 44 65 73 74 72 6f 79 3b 0a 20 20 20 20  = xDestroy;.    
0520: 70 4d 6f 64 20 3d 20 28 4d 6f 64 75 6c 65 20 2a  pMod = (Module *
0530: 29 73 71 6c 69 74 65 33 48 61 73 68 49 6e 73 65  )sqlite3HashInse
0540: 72 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 2c  rt(&db->aModule,
0550: 20 7a 43 6f 70 79 2c 20 6e 4e 61 6d 65 2c 20 28   zCopy, nName, (
0560: 76 6f 69 64 2a 29 70 4d 6f 64 29 3b 0a 20 20 20  void*)pMod);.   
0570: 20 69 66 28 20 70 4d 6f 64 20 26 26 20 70 4d 6f   if( pMod && pMo
0580: 64 2d 3e 78 44 65 73 74 72 6f 79 20 29 7b 0a 20  d->xDestroy ){. 
0590: 20 20 20 20 20 70 4d 6f 64 2d 3e 78 44 65 73 74       pMod->xDest
05a0: 72 6f 79 28 70 4d 6f 64 2d 3e 70 41 75 78 29 3b  roy(pMod->pAux);
05b0: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
05c0: 65 33 5f 66 72 65 65 28 70 4d 6f 64 29 3b 0a 20  e3_free(pMod);. 
05d0: 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49     sqlite3ResetI
05e0: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62  nternalSchema(db
05f0: 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d  , 0);.  }.  rc =
0600: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
0610: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a  db, SQLITE_OK);.
0620: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
0630: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29  leave(db->mutex)
0640: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
0650: 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 65 72 6e 61  .../*.** Externa
0660: 6c 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 75  l API function u
0670: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20  sed to create a 
0680: 6e 65 77 20 76 69 72 74 75 61 6c 2d 74 61 62 6c  new virtual-tabl
0690: 65 20 6d 6f 64 75 6c 65 2e 0a 2a 2f 0a 69 6e 74  e module..*/.int
06a0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
06b0: 6d 6f 64 75 6c 65 28 0a 20 20 73 71 6c 69 74 65  module(.  sqlite
06c0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
06d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
06e0: 61 62 61 73 65 20 69 6e 20 77 68 69 63 68 20 6d  abase in which m
06f0: 6f 64 75 6c 65 20 69 73 20 72 65 67 69 73 74 65  odule is registe
0700: 72 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  red */.  const c
0710: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 20 20  har *zName,     
0720: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65           /* Name
0730: 20 61 73 73 69 67 6e 65 64 20 74 6f 20 74 68 69   assigned to thi
0740: 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a 20 20 63 6f  s module */.  co
0750: 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75  nst sqlite3_modu
0760: 6c 65 20 2a 70 4d 6f 64 75 6c 65 2c 20 20 2f 2a  le *pModule,  /*
0770: 20 54 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20   The definition 
0780: 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f  of the module */
0790: 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 20 20 20  .  void *pAux   
07a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
07b0: 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 70 6f     /* Context po
07c0: 69 6e 74 65 72 20 66 6f 72 20 78 43 72 65 61 74  inter for xCreat
07d0: 65 2f 78 43 6f 6e 6e 65 63 74 20 2a 2f 0a 29 7b  e/xConnect */.){
07e0: 0a 20 20 72 65 74 75 72 6e 20 63 72 65 61 74 65  .  return create
07f0: 4d 6f 64 75 6c 65 28 64 62 2c 20 7a 4e 61 6d 65  Module(db, zName
0800: 2c 20 70 4d 6f 64 75 6c 65 2c 20 70 41 75 78 2c  , pModule, pAux,
0810: 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78   0);.}../*.** Ex
0820: 74 65 72 6e 61 6c 20 41 50 49 20 66 75 6e 63 74  ternal API funct
0830: 69 6f 6e 20 75 73 65 64 20 74 6f 20 63 72 65 61  ion used to crea
0840: 74 65 20 61 20 6e 65 77 20 76 69 72 74 75 61 6c  te a new virtual
0850: 2d 74 61 62 6c 65 20 6d 6f 64 75 6c 65 2e 0a 2a  -table module..*
0860: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72  /.int sqlite3_cr
0870: 65 61 74 65 5f 6d 6f 64 75 6c 65 5f 76 32 28 0a  eate_module_v2(.
0880: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
0890: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
08a0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 69 6e    /* Database in
08b0: 20 77 68 69 63 68 20 6d 6f 64 75 6c 65 20 69 73   which module is
08c0: 20 72 65 67 69 73 74 65 72 65 64 20 2a 2f 0a 20   registered */. 
08d0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
08e0: 6d 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  me,             
08f0: 20 2f 2a 20 4e 61 6d 65 20 61 73 73 69 67 6e 65   /* Name assigne
0900: 64 20 74 6f 20 74 68 69 73 20 6d 6f 64 75 6c 65  d to this module
0910: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69   */.  const sqli
0920: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64  te3_module *pMod
0930: 75 6c 65 2c 20 20 2f 2a 20 54 68 65 20 64 65 66  ule,  /* The def
0940: 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d  inition of the m
0950: 6f 64 75 6c 65 20 2a 2f 0a 20 20 76 6f 69 64 20  odule */.  void 
0960: 2a 70 41 75 78 2c 20 20 20 20 20 20 20 20 20 20  *pAux,          
0970: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
0980: 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 20 66 6f  ntext pointer fo
0990: 72 20 78 43 72 65 61 74 65 2f 78 43 6f 6e 6e 65  r xCreate/xConne
09a0: 63 74 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78  ct */.  void (*x
09b0: 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a 29  Destroy)(void *)
09c0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 64 75 6c          /* Modul
09d0: 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e  e destructor fun
09e0: 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 72 65  ction */.){.  re
09f0: 74 75 72 6e 20 63 72 65 61 74 65 4d 6f 64 75 6c  turn createModul
0a00: 65 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 70 4d 6f  e(db, zName, pMo
0a10: 64 75 6c 65 2c 20 70 41 75 78 2c 20 78 44 65 73  dule, pAux, xDes
0a20: 74 72 6f 79 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  troy);.}../*.** 
0a30: 4c 6f 63 6b 20 74 68 65 20 76 69 72 74 75 61 6c  Lock the virtual
0a40: 20 74 61 62 6c 65 20 73 6f 20 74 68 61 74 20 69   table so that i
0a50: 74 20 63 61 6e 6e 6f 74 20 62 65 20 64 69 73 63  t cannot be disc
0a60: 6f 6e 6e 65 63 74 65 64 2e 0a 2a 2a 20 4c 6f 63  onnected..** Loc
0a70: 6b 73 20 6e 65 73 74 2e 20 20 45 76 65 72 79 20  ks nest.  Every 
0a80: 6c 6f 63 6b 20 73 68 6f 75 6c 64 20 68 61 76 65  lock should have
0a90: 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67   a corresponding
0aa0: 20 75 6e 6c 6f 63 6b 2e 0a 2a 2a 20 49 66 20 61   unlock..** If a
0ab0: 6e 20 75 6e 6c 6f 63 6b 20 69 73 20 6f 6d 69 74  n unlock is omit
0ac0: 74 65 64 2c 20 72 65 73 6f 75 72 63 65 73 20 6c  ted, resources l
0ad0: 65 61 6b 73 20 77 69 6c 6c 20 6f 63 63 75 72 2e  eaks will occur.
0ae0: 20 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 64 69    .**.** If a di
0af0: 73 63 6f 6e 6e 65 63 74 20 69 73 20 61 74 74 65  sconnect is atte
0b00: 6d 70 74 65 64 20 77 68 69 6c 65 20 61 20 76 69  mpted while a vi
0b10: 72 74 75 61 6c 20 74 61 62 6c 65 20 69 73 20 6c  rtual table is l
0b20: 6f 63 6b 65 64 2c 0a 2a 2a 20 74 68 65 20 64 69  ocked,.** the di
0b30: 73 63 6f 6e 6e 65 63 74 20 69 73 20 64 65 66 65  sconnect is defe
0b40: 72 72 65 64 20 75 6e 74 69 6c 20 61 6c 6c 20 6c  rred until all l
0b50: 6f 63 6b 73 20 68 61 76 65 20 62 65 65 6e 20 72  ocks have been r
0b60: 65 6d 6f 76 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20  emoved..*/.void 
0b70: 73 71 6c 69 74 65 33 56 74 61 62 4c 6f 63 6b 28  sqlite3VtabLock(
0b80: 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56  sqlite3_vtab *pV
0b90: 74 61 62 29 7b 0a 20 20 70 56 74 61 62 2d 3e 6e  tab){.  pVtab->n
0ba0: 52 65 66 2b 2b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Ref++;.}../*.** 
0bb0: 55 6e 6c 6f 63 6b 20 61 20 76 69 72 74 75 61 6c  Unlock a virtual
0bc0: 20 74 61 62 6c 65 2e 20 20 57 68 65 6e 20 74 68   table.  When th
0bd0: 65 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73 20 72  e last lock is r
0be0: 65 6d 6f 76 65 64 2c 0a 2a 2a 20 64 69 73 63 6f  emoved,.** disco
0bf0: 6e 6e 65 63 74 20 74 68 65 20 76 69 72 74 75 61  nnect the virtua
0c00: 6c 20 74 61 62 6c 65 2e 0a 2a 2f 0a 76 6f 69 64  l table..*/.void
0c10: 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f   sqlite3VtabUnlo
0c20: 63 6b 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  ck(sqlite3 *db, 
0c30: 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56  sqlite3_vtab *pV
0c40: 74 61 62 29 7b 0a 20 20 70 56 74 61 62 2d 3e 6e  tab){.  pVtab->n
0c50: 52 65 66 2d 2d 3b 0a 20 20 61 73 73 65 72 74 28  Ref--;.  assert(
0c60: 64 62 29 3b 0a 20 20 61 73 73 65 72 74 28 21 73  db);.  assert(!s
0c70: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63  qlite3SafetyChec
0c80: 6b 28 64 62 29 29 3b 0a 20 20 69 66 28 20 70 56  k(db));.  if( pV
0c90: 74 61 62 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a  tab->nRef==0 ){.
0ca0: 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61 67 69      if( db->magi
0cb0: 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  c==SQLITE_MAGIC_
0cc0: 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 73 71  BUSY ){.      sq
0cd0: 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64  lite3SafetyOff(d
0ce0: 62 29 3b 0a 20 20 20 20 20 20 70 56 74 61 62 2d  b);.      pVtab-
0cf0: 3e 70 4d 6f 64 75 6c 65 2d 3e 78 44 69 73 63 6f  >pModule->xDisco
0d00: 6e 6e 65 63 74 28 70 56 74 61 62 29 3b 0a 20 20  nnect(pVtab);.  
0d10: 20 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74      sqlite3Safet
0d20: 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20 7d 20 65  yOn(db);.    } e
0d30: 6c 73 65 20 7b 0a 20 20 20 20 20 20 70 56 74 61  lse {.      pVta
0d40: 62 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 44 69 73  b->pModule->xDis
0d50: 63 6f 6e 6e 65 63 74 28 70 56 74 61 62 29 3b 0a  connect(pVtab);.
0d60: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
0d70: 2a 2a 20 43 6c 65 61 72 20 61 6e 79 20 61 6e 64  ** Clear any and
0d80: 20 61 6c 6c 20 76 69 72 74 75 61 6c 2d 74 61 62   all virtual-tab
0d90: 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  le information f
0da0: 72 6f 6d 20 74 68 65 20 54 61 62 6c 65 20 72 65  rom the Table re
0db0: 63 6f 72 64 2e 0a 2a 2a 20 54 68 69 73 20 72 6f  cord..** This ro
0dc0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c  utine is called,
0dd0: 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 6a 75   for example, ju
0de0: 73 74 20 62 65 66 6f 72 65 20 64 65 6c 65 74 69  st before deleti
0df0: 6e 67 20 74 68 65 20 54 61 62 6c 65 0a 2a 2a 20  ng the Table.** 
0e00: 72 65 63 6f 72 64 2e 0a 2a 2f 0a 76 6f 69 64 20  record..*/.void 
0e10: 73 71 6c 69 74 65 33 56 74 61 62 43 6c 65 61 72  sqlite3VtabClear
0e20: 28 54 61 62 6c 65 20 2a 70 29 7b 0a 20 20 73 71  (Table *p){.  sq
0e30: 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61  lite3_vtab *pVta
0e40: 62 20 3d 20 70 2d 3e 70 56 74 61 62 3b 0a 20 20  b = p->pVtab;.  
0e50: 69 66 28 20 70 56 74 61 62 20 29 7b 0a 20 20 20  if( pVtab ){.   
0e60: 20 61 73 73 65 72 74 28 20 70 2d 3e 70 4d 6f 64   assert( p->pMod
0e70: 20 26 26 20 70 2d 3e 70 4d 6f 64 2d 3e 70 4d 6f   && p->pMod->pMo
0e80: 64 75 6c 65 20 29 3b 0a 20 20 20 20 73 71 6c 69  dule );.    sqli
0e90: 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 70 2d  te3VtabUnlock(p-
0ea0: 3e 70 53 63 68 65 6d 61 2d 3e 64 62 2c 20 70 56  >pSchema->db, pV
0eb0: 74 61 62 29 3b 0a 20 20 20 20 70 2d 3e 70 56 74  tab);.    p->pVt
0ec0: 61 62 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66  ab = 0;.  }.  if
0ed0: 28 20 70 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67  ( p->azModuleArg
0ee0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20   ){.    int i;. 
0ef0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
0f00: 3e 6e 4d 6f 64 75 6c 65 41 72 67 3b 20 69 2b 2b  >nModuleArg; i++
0f10: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
0f20: 5f 66 72 65 65 28 70 2d 3e 61 7a 4d 6f 64 75 6c  _free(p->azModul
0f30: 65 41 72 67 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a  eArg[i]);.    }.
0f40: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
0f50: 28 70 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 29  (p->azModuleArg)
0f60: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  ;.  }.}../*.** A
0f70: 64 64 20 61 20 6e 65 77 20 6d 6f 64 75 6c 65 20  dd a new module 
0f80: 61 72 67 75 6d 65 6e 74 20 74 6f 20 70 54 61 62  argument to pTab
0f90: 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 5b  le->azModuleArg[
0fa0: 5d 2e 0a 2a 2a 20 54 68 65 20 73 74 72 69 6e 67  ]..** The string
0fb0: 20 69 73 20 6e 6f 74 20 63 6f 70 69 65 64 20 2d   is not copied -
0fc0: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20   the pointer is 
0fd0: 73 74 6f 72 65 64 2e 20 20 54 68 65 0a 2a 2a 20  stored.  The.** 
0fe0: 73 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 66  string will be f
0ff0: 72 65 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c  reed automatical
1000: 6c 79 20 77 68 65 6e 20 74 68 65 20 74 61 62 6c  ly when the tabl
1010: 65 20 69 73 0a 2a 2a 20 64 65 6c 65 74 65 64 2e  e is.** deleted.
1020: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
1030: 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 6d 65 6e  addModuleArgumen
1040: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 54  t(sqlite3 *db, T
1050: 61 62 6c 65 20 2a 70 54 61 62 6c 65 2c 20 63 68  able *pTable, ch
1060: 61 72 20 2a 7a 41 72 67 29 7b 0a 20 20 69 6e 74  ar *zArg){.  int
1070: 20 69 20 3d 20 70 54 61 62 6c 65 2d 3e 6e 4d 6f   i = pTable->nMo
1080: 64 75 6c 65 41 72 67 2b 2b 3b 0a 20 20 69 6e 74  duleArg++;.  int
1090: 20 6e 42 79 74 65 73 20 3d 20 73 69 7a 65 6f 66   nBytes = sizeof
10a0: 28 63 68 61 72 20 2a 29 2a 28 31 2b 70 54 61 62  (char *)*(1+pTab
10b0: 6c 65 2d 3e 6e 4d 6f 64 75 6c 65 41 72 67 29 3b  le->nModuleArg);
10c0: 0a 20 20 63 68 61 72 20 2a 2a 61 7a 4d 6f 64 75  .  char **azModu
10d0: 6c 65 41 72 67 3b 0a 20 20 61 7a 4d 6f 64 75 6c  leArg;.  azModul
10e0: 65 41 72 67 20 3d 20 73 71 6c 69 74 65 33 44 62  eArg = sqlite3Db
10f0: 52 65 61 6c 6c 6f 63 28 64 62 2c 20 70 54 61 62  Realloc(db, pTab
1100: 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 2c  le->azModuleArg,
1110: 20 6e 42 79 74 65 73 29 3b 0a 20 20 69 66 28 20   nBytes);.  if( 
1120: 61 7a 4d 6f 64 75 6c 65 41 72 67 3d 3d 30 20 29  azModuleArg==0 )
1130: 7b 0a 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20 20  {.    int j;.   
1140: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 69 3b 20 6a   for(j=0; j<i; j
1150: 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ++){.      sqlit
1160: 65 33 5f 66 72 65 65 28 70 54 61 62 6c 65 2d 3e  e3_free(pTable->
1170: 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 6a 5d 29 3b  azModuleArg[j]);
1180: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
1190: 65 33 5f 66 72 65 65 28 7a 41 72 67 29 3b 0a 20  e3_free(zArg);. 
11a0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
11b0: 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c 65  pTable->azModule
11c0: 41 72 67 29 3b 0a 20 20 20 20 70 54 61 62 6c 65  Arg);.    pTable
11d0: 2d 3e 6e 4d 6f 64 75 6c 65 41 72 67 20 3d 20 30  ->nModuleArg = 0
11e0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61  ;.  }else{.    a
11f0: 7a 4d 6f 64 75 6c 65 41 72 67 5b 69 5d 20 3d 20  zModuleArg[i] = 
1200: 7a 41 72 67 3b 0a 20 20 20 20 61 7a 4d 6f 64 75  zArg;.    azModu
1210: 6c 65 41 72 67 5b 69 2b 31 5d 20 3d 20 30 3b 0a  leArg[i+1] = 0;.
1220: 20 20 7d 0a 20 20 70 54 61 62 6c 65 2d 3e 61 7a    }.  pTable->az
1230: 4d 6f 64 75 6c 65 41 72 67 20 3d 20 61 7a 4d 6f  ModuleArg = azMo
1240: 64 75 6c 65 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a 2a  duleArg;.}../*.*
1250: 2a 20 54 68 65 20 70 61 72 73 65 72 20 63 61 6c  * The parser cal
1260: 6c 73 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  ls this routine 
1270: 77 68 65 6e 20 69 74 20 66 69 72 73 74 20 73 65  when it first se
1280: 65 73 20 61 20 43 52 45 41 54 45 20 56 49 52 54  es a CREATE VIRT
1290: 55 41 4c 20 54 41 42 4c 45 0a 2a 2a 20 73 74 61  UAL TABLE.** sta
12a0: 74 65 6d 65 6e 74 2e 20 20 54 68 65 20 6d 6f 64  tement.  The mod
12b0: 75 6c 65 20 6e 61 6d 65 20 68 61 73 20 62 65 65  ule name has bee
12c0: 6e 20 70 61 72 73 65 64 2c 20 62 75 74 20 74 68  n parsed, but th
12d0: 65 20 6f 70 74 69 6f 6e 61 6c 20 6c 69 73 74 0a  e optional list.
12e0: 2a 2a 20 6f 66 20 70 61 72 61 6d 65 74 65 72 73  ** of parameters
12f0: 20 74 68 61 74 20 66 6f 6c 6c 6f 77 20 74 68 65   that follow the
1300: 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 61 72 65   module name are
1310: 20 73 74 69 6c 6c 20 70 65 6e 64 69 6e 67 2e 0a   still pending..
1320: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
1330: 74 61 62 42 65 67 69 6e 50 61 72 73 65 28 0a 20  tabBeginParse(. 
1340: 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20   Parse *pParse, 
1350: 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e         /* Parsin
1360: 67 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54  g context */.  T
1370: 6f 6b 65 6e 20 2a 70 4e 61 6d 65 31 2c 20 20 20  oken *pName1,   
1380: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20       /* Name of 
1390: 6e 65 77 20 74 61 62 6c 65 2c 20 6f 72 20 64 61  new table, or da
13a0: 74 61 62 61 73 65 20 6e 61 6d 65 20 2a 2f 0a 20  tabase name */. 
13b0: 20 54 6f 6b 65 6e 20 2a 70 4e 61 6d 65 32 2c 20   Token *pName2, 
13c0: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f         /* Name o
13d0: 66 20 6e 65 77 20 74 61 62 6c 65 20 6f 72 20 4e  f new table or N
13e0: 55 4c 4c 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 2a  ULL */.  Token *
13f0: 70 4d 6f 64 75 6c 65 4e 61 6d 65 20 20 20 20 2f  pModuleName    /
1400: 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6d 6f  * Name of the mo
1410: 64 75 6c 65 20 66 6f 72 20 74 68 65 20 76 69 72  dule for the vir
1420: 74 75 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 29 7b  tual table */.){
1430: 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20  .  int iDb;     
1440: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
1450: 64 61 74 61 62 61 73 65 20 74 68 65 20 74 61 62  database the tab
1460: 6c 65 20 69 73 20 62 65 69 6e 67 20 63 72 65 61  le is being crea
1470: 74 65 64 20 69 6e 20 2a 2f 0a 20 20 54 61 62 6c  ted in */.  Tabl
1480: 65 20 2a 70 54 61 62 6c 65 3b 20 20 20 20 20 20  e *pTable;      
1490: 20 20 2f 2a 20 54 68 65 20 6e 65 77 20 76 69 72    /* The new vir
14a0: 74 75 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 20 20  tual table */.  
14b0: 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20  sqlite3 *db;    
14c0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
14d0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a  e connection */.
14e0: 0a 20 20 69 66 28 20 70 50 61 72 73 65 2d 3e 64  .  if( pParse->d
14f0: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54  b->flags & SQLIT
1500: 45 5f 53 68 61 72 65 64 43 61 63 68 65 20 29 7b  E_SharedCache ){
1510: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
1520: 72 4d 73 67 28 70 50 61 72 73 65 2c 20 22 43 61  rMsg(pParse, "Ca
1530: 6e 6e 6f 74 20 75 73 65 20 76 69 72 74 75 61 6c  nnot use virtual
1540: 20 74 61 62 6c 65 73 20 69 6e 20 73 68 61 72 65   tables in share
1550: 64 2d 63 61 63 68 65 20 6d 6f 64 65 22 29 3b 0a  d-cache mode");.
1560: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
1570: 0a 20 20 73 71 6c 69 74 65 33 53 74 61 72 74 54  .  sqlite3StartT
1580: 61 62 6c 65 28 70 50 61 72 73 65 2c 20 70 4e 61  able(pParse, pNa
1590: 6d 65 31 2c 20 70 4e 61 6d 65 32 2c 20 30 2c 20  me1, pName2, 0, 
15a0: 30 2c 20 31 2c 20 30 29 3b 0a 20 20 70 54 61 62  0, 1, 0);.  pTab
15b0: 6c 65 20 3d 20 70 50 61 72 73 65 2d 3e 70 4e 65  le = pParse->pNe
15c0: 77 54 61 62 6c 65 3b 0a 20 20 69 66 28 20 70 54  wTable;.  if( pT
15d0: 61 62 6c 65 3d 3d 30 20 7c 7c 20 70 50 61 72 73  able==0 || pPars
15e0: 65 2d 3e 6e 45 72 72 20 29 20 72 65 74 75 72 6e  e->nErr ) return
15f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70  ;.  assert( 0==p
1600: 54 61 62 6c 65 2d 3e 70 49 6e 64 65 78 20 29 3b  Table->pIndex );
1610: 0a 0a 20 20 64 62 20 3d 20 70 50 61 72 73 65 2d  ..  db = pParse-
1620: 3e 64 62 3b 0a 20 20 69 44 62 20 3d 20 73 71 6c  >db;.  iDb = sql
1630: 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65  ite3SchemaToInde
1640: 78 28 64 62 2c 20 70 54 61 62 6c 65 2d 3e 70 53  x(db, pTable->pS
1650: 63 68 65 6d 61 29 3b 0a 20 20 61 73 73 65 72 74  chema);.  assert
1660: 28 20 69 44 62 3e 3d 30 20 29 3b 0a 0a 20 20 70  ( iDb>=0 );..  p
1670: 54 61 62 6c 65 2d 3e 69 73 56 69 72 74 75 61 6c  Table->isVirtual
1680: 20 3d 20 31 3b 0a 20 20 70 54 61 62 6c 65 2d 3e   = 1;.  pTable->
1690: 6e 4d 6f 64 75 6c 65 41 72 67 20 3d 20 30 3b 0a  nModuleArg = 0;.
16a0: 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67 75 6d    addModuleArgum
16b0: 65 6e 74 28 64 62 2c 20 70 54 61 62 6c 65 2c 20  ent(db, pTable, 
16c0: 73 71 6c 69 74 65 33 4e 61 6d 65 46 72 6f 6d 54  sqlite3NameFromT
16d0: 6f 6b 65 6e 28 64 62 2c 20 70 4d 6f 64 75 6c 65  oken(db, pModule
16e0: 4e 61 6d 65 29 29 3b 0a 20 20 61 64 64 4d 6f 64  Name));.  addMod
16f0: 75 6c 65 41 72 67 75 6d 65 6e 74 28 64 62 2c 20  uleArgument(db, 
1700: 70 54 61 62 6c 65 2c 20 73 71 6c 69 74 65 33 44  pTable, sqlite3D
1710: 62 53 74 72 44 75 70 28 64 62 2c 20 64 62 2d 3e  bStrDup(db, db->
1720: 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 29  aDb[iDb].zName))
1730: 3b 0a 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67  ;.  addModuleArg
1740: 75 6d 65 6e 74 28 64 62 2c 20 70 54 61 62 6c 65  ument(db, pTable
1750: 2c 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 75  , sqlite3DbStrDu
1760: 70 28 64 62 2c 20 70 54 61 62 6c 65 2d 3e 7a 4e  p(db, pTable->zN
1770: 61 6d 65 29 29 3b 0a 20 20 70 50 61 72 73 65 2d  ame));.  pParse-
1780: 3e 73 4e 61 6d 65 54 6f 6b 65 6e 2e 6e 20 3d 20  >sNameToken.n = 
1790: 70 4d 6f 64 75 6c 65 4e 61 6d 65 2d 3e 7a 20 2b  pModuleName->z +
17a0: 20 70 4d 6f 64 75 6c 65 4e 61 6d 65 2d 3e 6e 20   pModuleName->n 
17b0: 2d 20 70 4e 61 6d 65 31 2d 3e 7a 3b 0a 0a 23 69  - pName1->z;..#i
17c0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
17d0: 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a  T_AUTHORIZATION.
17e0: 20 20 2f 2a 20 43 72 65 61 74 69 6e 67 20 61 20    /* Creating a 
17f0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 69 6e  virtual table in
1800: 76 6f 6b 65 73 20 74 68 65 20 61 75 74 68 6f 72  vokes the author
1810: 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b  ization callback
1820: 20 74 77 69 63 65 2e 0a 20 20 2a 2a 20 54 68 65   twice..  ** The
1830: 20 66 69 72 73 74 20 69 6e 76 6f 63 61 74 69 6f   first invocatio
1840: 6e 2c 20 74 6f 20 6f 62 74 61 69 6e 20 70 65 72  n, to obtain per
1850: 6d 69 73 73 69 6f 6e 20 74 6f 20 49 4e 53 45 52  mission to INSER
1860: 54 20 61 20 72 6f 77 20 69 6e 74 6f 20 74 68 65  T a row into the
1870: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 5f 6d 61 73  .  ** sqlite_mas
1880: 74 65 72 20 74 61 62 6c 65 2c 20 68 61 73 20 61  ter table, has a
1890: 6c 72 65 61 64 79 20 62 65 65 6e 20 6d 61 64 65  lready been made
18a0: 20 62 79 20 73 71 6c 69 74 65 33 53 74 61 72 74   by sqlite3Start
18b0: 54 61 62 6c 65 28 29 2e 0a 20 20 2a 2a 20 54 68  Table()..  ** Th
18c0: 65 20 73 65 63 6f 6e 64 20 63 61 6c 6c 2c 20 74  e second call, t
18d0: 6f 20 6f 62 74 61 69 6e 20 70 65 72 6d 69 73 73  o obtain permiss
18e0: 69 6f 6e 20 74 6f 20 63 72 65 61 74 65 20 74 68  ion to create th
18f0: 65 20 74 61 62 6c 65 2c 20 69 73 20 6d 61 64 65  e table, is made
1900: 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 28   now..  */.  if(
1910: 20 70 54 61 62 6c 65 2d 3e 61 7a 4d 6f 64 75 6c   pTable->azModul
1920: 65 41 72 67 20 29 7b 0a 20 20 20 20 73 71 6c 69  eArg ){.    sqli
1930: 74 65 33 41 75 74 68 43 68 65 63 6b 28 70 50 61  te3AuthCheck(pPa
1940: 72 73 65 2c 20 53 51 4c 49 54 45 5f 43 52 45 41  rse, SQLITE_CREA
1950: 54 45 5f 56 54 41 42 4c 45 2c 20 70 54 61 62 6c  TE_VTABLE, pTabl
1960: 65 2d 3e 7a 4e 61 6d 65 2c 20 0a 20 20 20 20 20  e->zName, .     
1970: 20 20 20 20 20 20 20 70 54 61 62 6c 65 2d 3e 61         pTable->a
1980: 7a 4d 6f 64 75 6c 65 41 72 67 5b 30 5d 2c 20 70  zModuleArg[0], p
1990: 50 61 72 73 65 2d 3e 64 62 2d 3e 61 44 62 5b 69  Parse->db->aDb[i
19a0: 44 62 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 20 7d 0a  Db].zName);.  }.
19b0: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
19c0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 74 61 6b  This routine tak
19d0: 65 73 20 74 68 65 20 6d 6f 64 75 6c 65 20 61 72  es the module ar
19e0: 67 75 6d 65 6e 74 20 74 68 61 74 20 68 61 73 20  gument that has 
19f0: 62 65 65 6e 20 61 63 63 75 6d 75 6c 61 74 69 6e  been accumulatin
1a00: 67 0a 2a 2a 20 69 6e 20 70 50 61 72 73 65 2d 3e  g.** in pParse->
1a10: 7a 41 72 67 5b 5d 20 61 6e 64 20 61 70 70 65 6e  zArg[] and appen
1a20: 64 73 20 69 74 20 74 6f 20 74 68 65 20 6c 69 73  ds it to the lis
1a30: 74 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 6f  t of arguments o
1a40: 6e 20 74 68 65 0a 2a 2a 20 76 69 72 74 75 61 6c  n the.** virtual
1a50: 20 74 61 62 6c 65 20 63 75 72 72 65 6e 74 6c 79   table currently
1a60: 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 74   under construct
1a70: 69 6f 6e 20 69 6e 20 70 50 61 72 73 65 2d 3e 70  ion in pParse->p
1a80: 54 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63  Table..*/.static
1a90: 20 76 6f 69 64 20 61 64 64 41 72 67 75 6d 65 6e   void addArgumen
1aa0: 74 54 6f 56 74 61 62 28 50 61 72 73 65 20 2a 70  tToVtab(Parse *p
1ab0: 50 61 72 73 65 29 7b 0a 20 20 69 66 28 20 70 50  Parse){.  if( pP
1ac0: 61 72 73 65 2d 3e 73 41 72 67 2e 7a 20 26 26 20  arse->sArg.z && 
1ad0: 70 50 61 72 73 65 2d 3e 70 4e 65 77 54 61 62 6c  pParse->pNewTabl
1ae0: 65 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63  e ){.    const c
1af0: 68 61 72 20 2a 7a 20 3d 20 28 63 6f 6e 73 74 20  har *z = (const 
1b00: 63 68 61 72 2a 29 70 50 61 72 73 65 2d 3e 73 41  char*)pParse->sA
1b10: 72 67 2e 7a 3b 0a 20 20 20 20 69 6e 74 20 6e 20  rg.z;.    int n 
1b20: 3d 20 70 50 61 72 73 65 2d 3e 73 41 72 67 2e 6e  = pParse->sArg.n
1b30: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64  ;.    sqlite3 *d
1b40: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a  b = pParse->db;.
1b50: 20 20 20 20 61 64 64 4d 6f 64 75 6c 65 41 72 67      addModuleArg
1b60: 75 6d 65 6e 74 28 64 62 2c 20 70 50 61 72 73 65  ument(db, pParse
1b70: 2d 3e 70 4e 65 77 54 61 62 6c 65 2c 20 73 71 6c  ->pNewTable, sql
1b80: 69 74 65 33 44 62 53 74 72 4e 44 75 70 28 64 62  ite3DbStrNDup(db
1b90: 2c 20 7a 2c 20 6e 29 29 3b 0a 20 20 7d 0a 7d 0a  , z, n));.  }.}.
1ba0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 72 73 65  ./*.** The parse
1bb0: 72 20 63 61 6c 6c 73 20 74 68 69 73 20 72 6f 75  r calls this rou
1bc0: 74 69 6e 65 20 61 66 74 65 72 20 74 68 65 20 43  tine after the C
1bd0: 52 45 41 54 45 20 56 49 52 54 55 41 4c 20 54 41  REATE VIRTUAL TA
1be0: 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a  BLE statement.**
1bf0: 20 68 61 73 20 62 65 65 6e 20 63 6f 6d 70 6c 65   has been comple
1c00: 74 65 6c 79 20 70 61 72 73 65 64 2e 0a 2a 2f 0a  tely parsed..*/.
1c10: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62  void sqlite3Vtab
1c20: 46 69 6e 69 73 68 50 61 72 73 65 28 50 61 72 73  FinishParse(Pars
1c30: 65 20 2a 70 50 61 72 73 65 2c 20 54 6f 6b 65 6e  e *pParse, Token
1c40: 20 2a 70 45 6e 64 29 7b 0a 20 20 54 61 62 6c 65   *pEnd){.  Table
1c50: 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 20 2f   *pTab;        /
1c60: 2a 20 54 68 65 20 74 61 62 6c 65 20 62 65 69 6e  * The table bein
1c70: 67 20 63 6f 6e 73 74 72 75 63 74 65 64 20 2a 2f  g constructed */
1c80: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20  .  sqlite3 *db; 
1c90: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61         /* The da
1ca0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
1cb0: 6e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4d 6f  n */.  char *zMo
1cc0: 64 75 6c 65 3b 20 20 20 20 20 20 2f 2a 20 54 68  dule;      /* Th
1cd0: 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 6f 66  e module name of
1ce0: 20 74 68 65 20 74 61 62 6c 65 3a 20 55 53 49 4e   the table: USIN
1cf0: 47 20 6d 6f 64 75 6c 65 6e 61 6d 65 20 2a 2f 0a  G modulename */.
1d00: 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 20 3d    Module *pMod =
1d10: 20 30 3b 0a 0a 20 20 61 64 64 41 72 67 75 6d 65   0;..  addArgume
1d20: 6e 74 54 6f 56 74 61 62 28 70 50 61 72 73 65 29  ntToVtab(pParse)
1d30: 3b 0a 20 20 70 50 61 72 73 65 2d 3e 73 41 72 67  ;.  pParse->sArg
1d40: 2e 7a 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 4c 6f  .z = 0;..  /* Lo
1d50: 6f 6b 75 70 20 74 68 65 20 6d 6f 64 75 6c 65 20  okup the module 
1d60: 6e 61 6d 65 2e 20 2a 2f 0a 20 20 70 54 61 62 20  name. */.  pTab 
1d70: 3d 20 70 50 61 72 73 65 2d 3e 70 4e 65 77 54 61  = pParse->pNewTa
1d80: 62 6c 65 3b 0a 20 20 69 66 28 20 70 54 61 62 3d  ble;.  if( pTab=
1d90: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 64  =0 ) return;.  d
1da0: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a  b = pParse->db;.
1db0: 20 20 69 66 28 20 70 54 61 62 2d 3e 6e 4d 6f 64    if( pTab->nMod
1dc0: 75 6c 65 41 72 67 3c 31 20 29 20 72 65 74 75 72  uleArg<1 ) retur
1dd0: 6e 3b 0a 20 20 7a 4d 6f 64 75 6c 65 20 3d 20 70  n;.  zModule = p
1de0: 54 61 62 2d 3e 61 7a 4d 6f 64 75 6c 65 41 72 67  Tab->azModuleArg
1df0: 5b 30 5d 3b 0a 20 20 70 4d 6f 64 20 3d 20 28 4d  [0];.  pMod = (M
1e00: 6f 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 33 48  odule *)sqlite3H
1e10: 61 73 68 46 69 6e 64 28 26 64 62 2d 3e 61 4d 6f  ashFind(&db->aMo
1e20: 64 75 6c 65 2c 20 7a 4d 6f 64 75 6c 65 2c 20 73  dule, zModule, s
1e30: 74 72 6c 65 6e 28 7a 4d 6f 64 75 6c 65 29 29 3b  trlen(zModule));
1e40: 0a 20 20 70 54 61 62 2d 3e 70 4d 6f 64 20 3d 20  .  pTab->pMod = 
1e50: 70 4d 6f 64 3b 0a 20 20 0a 20 20 2f 2a 20 49 66  pMod;.  .  /* If
1e60: 20 74 68 65 20 43 52 45 41 54 45 20 56 49 52 54   the CREATE VIRT
1e70: 55 41 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d  UAL TABLE statem
1e80: 65 6e 74 20 69 73 20 62 65 69 6e 67 20 65 6e 74  ent is being ent
1e90: 65 72 65 64 20 66 6f 72 20 74 68 65 0a 20 20 2a  ered for the.  *
1ea0: 2a 20 66 69 72 73 74 20 74 69 6d 65 20 28 69 6e  * first time (in
1eb0: 20 6f 74 68 65 72 20 77 6f 72 64 73 20 69 66 20   other words if 
1ec0: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
1ed0: 65 20 69 73 20 61 63 74 75 61 6c 6c 79 20 62 65  e is actually be
1ee0: 69 6e 67 0a 20 20 2a 2a 20 63 72 65 61 74 65 64  ing.  ** created
1ef0: 20 6e 6f 77 20 69 6e 73 74 65 61 64 20 6f 66 20   now instead of 
1f00: 6a 75 73 74 20 62 65 69 6e 67 20 72 65 61 64 20  just being read 
1f10: 6f 75 74 20 6f 66 20 73 71 6c 69 74 65 5f 6d 61  out of sqlite_ma
1f20: 73 74 65 72 29 20 74 68 65 6e 0a 20 20 2a 2a 20  ster) then.  ** 
1f30: 64 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  do additional in
1f40: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 77 6f 72  itialization wor
1f50: 6b 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20  k and store the 
1f60: 73 74 61 74 65 6d 65 6e 74 20 74 65 78 74 0a 20  statement text. 
1f70: 20 2a 2a 20 69 6e 20 74 68 65 20 73 71 6c 69 74   ** in the sqlit
1f80: 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 2e 0a  e_master table..
1f90: 20 20 2a 2f 0a 20 20 69 66 28 20 21 64 62 2d 3e    */.  if( !db->
1fa0: 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20 20  init.busy ){.   
1fb0: 20 63 68 61 72 20 2a 7a 53 74 6d 74 3b 0a 20 20   char *zStmt;.  
1fc0: 20 20 63 68 61 72 20 2a 7a 57 68 65 72 65 3b 0a    char *zWhere;.
1fd0: 20 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 20      int iDb;.   
1fe0: 20 56 64 62 65 20 2a 76 3b 0a 0a 20 20 20 20 2f   Vdbe *v;..    /
1ff0: 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 63 6f  * Compute the co
2000: 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 74  mplete text of t
2010: 68 65 20 43 52 45 41 54 45 20 56 49 52 54 55 41  he CREATE VIRTUA
2020: 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e  L TABLE statemen
2030: 74 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 45 6e  t */.    if( pEn
2040: 64 20 29 7b 0a 20 20 20 20 20 20 70 50 61 72 73  d ){.      pPars
2050: 65 2d 3e 73 4e 61 6d 65 54 6f 6b 65 6e 2e 6e 20  e->sNameToken.n 
2060: 3d 20 70 45 6e 64 2d 3e 7a 20 2d 20 70 50 61 72  = pEnd->z - pPar
2070: 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b 65 6e 2e 7a  se->sNameToken.z
2080: 20 2b 20 70 45 6e 64 2d 3e 6e 3b 0a 20 20 20 20   + pEnd->n;.    
2090: 7d 0a 20 20 20 20 7a 53 74 6d 74 20 3d 20 73 71  }.    zStmt = sq
20a0: 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c  lite3MPrintf(db,
20b0: 20 22 43 52 45 41 54 45 20 56 49 52 54 55 41 4c   "CREATE VIRTUAL
20c0: 20 54 41 42 4c 45 20 25 54 22 2c 20 26 70 50 61   TABLE %T", &pPa
20d0: 72 73 65 2d 3e 73 4e 61 6d 65 54 6f 6b 65 6e 29  rse->sNameToken)
20e0: 3b 0a 0a 20 20 20 20 2f 2a 20 41 20 73 6c 6f 74  ;..    /* A slot
20f0: 20 66 6f 72 20 74 68 65 20 72 65 63 6f 72 64 20   for the record 
2100: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e  has already been
2110: 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 74 68   allocated in th
2120: 65 20 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45  e .    ** SQLITE
2130: 5f 4d 41 53 54 45 52 20 74 61 62 6c 65 2e 20 20  _MASTER table.  
2140: 57 65 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20  We just need to 
2150: 75 70 64 61 74 65 20 74 68 61 74 20 73 6c 6f 74  update that slot
2160: 20 77 69 74 68 20 61 6c 6c 0a 20 20 20 20 2a 2a   with all.    **
2170: 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e   the information
2180: 20 77 65 27 76 65 20 63 6f 6c 6c 65 63 74 65 64   we've collected
2190: 2e 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a  .  .    **.    *
21a0: 2a 20 54 68 65 20 74 6f 70 20 6f 66 20 74 68 65  * The top of the
21b0: 20 73 74 61 63 6b 20 69 73 20 74 68 65 20 72 6f   stack is the ro
21c0: 6f 74 70 61 67 65 20 61 6c 6c 6f 63 61 74 65 64  otpage allocated
21d0: 20 62 79 20 73 71 6c 69 74 65 33 53 74 61 72 74   by sqlite3Start
21e0: 54 61 62 6c 65 28 29 2e 0a 20 20 20 20 2a 2a 20  Table()..    ** 
21f0: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 61 6c  This value is al
2200: 77 61 79 73 20 30 20 61 6e 64 20 69 73 20 69 67  ways 0 and is ig
2210: 6e 6f 72 65 64 2c 20 61 20 76 69 72 74 75 61 6c  nored, a virtual
2220: 20 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f 74 20   table does not 
2230: 68 61 76 65 20 61 0a 20 20 20 20 2a 2a 20 72 6f  have a.    ** ro
2240: 6f 74 70 61 67 65 2e 20 54 68 65 20 6e 65 78 74  otpage. The next
2250: 20 65 6e 74 72 79 20 6f 6e 20 74 68 65 20 73 74   entry on the st
2260: 61 63 6b 20 69 73 20 74 68 65 20 72 6f 77 69 64  ack is the rowid
2270: 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 0a 20   of the record. 
2280: 20 20 20 2a 2a 20 69 6e 20 74 68 65 20 73 71 6c     ** in the sql
2290: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
22a0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 44 62  ..    */.    iDb
22b0: 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61   = sqlite3Schema
22c0: 54 6f 49 6e 64 65 78 28 64 62 2c 20 70 54 61 62  ToIndex(db, pTab
22d0: 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20  ->pSchema);.    
22e0: 73 71 6c 69 74 65 33 4e 65 73 74 65 64 50 61 72  sqlite3NestedPar
22f0: 73 65 28 70 50 61 72 73 65 2c 0a 20 20 20 20 20  se(pParse,.     
2300: 20 22 55 50 44 41 54 45 20 25 51 2e 25 73 20 22   "UPDATE %Q.%s "
2310: 0a 20 20 20 20 20 20 20 20 20 22 53 45 54 20 74  .         "SET t
2320: 79 70 65 3d 27 74 61 62 6c 65 27 2c 20 6e 61 6d  ype='table', nam
2330: 65 3d 25 51 2c 20 74 62 6c 5f 6e 61 6d 65 3d 25  e=%Q, tbl_name=%
2340: 51 2c 20 72 6f 6f 74 70 61 67 65 3d 30 2c 20 73  Q, rootpage=0, s
2350: 71 6c 3d 25 51 20 22 0a 20 20 20 20 20 20 20 22  ql=%Q ".       "
2360: 57 48 45 52 45 20 72 6f 77 69 64 3d 23 31 22 2c  WHERE rowid=#1",
2370: 0a 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69  .      db->aDb[i
2380: 44 62 5d 2e 7a 4e 61 6d 65 2c 20 53 43 48 45 4d  Db].zName, SCHEM
2390: 41 5f 54 41 42 4c 45 28 69 44 62 29 2c 0a 20 20  A_TABLE(iDb),.  
23a0: 20 20 20 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c      pTab->zName,
23b0: 0a 20 20 20 20 20 20 70 54 61 62 2d 3e 7a 4e 61  .      pTab->zNa
23c0: 6d 65 2c 0a 20 20 20 20 20 20 7a 53 74 6d 74 0a  me,.      zStmt.
23d0: 20 20 20 20 29 3b 0a 20 20 20 20 73 71 6c 69 74      );.    sqlit
23e0: 65 33 5f 66 72 65 65 28 7a 53 74 6d 74 29 3b 0a  e3_free(zStmt);.
23f0: 20 20 20 20 76 20 3d 20 73 71 6c 69 74 65 33 47      v = sqlite3G
2400: 65 74 56 64 62 65 28 70 50 61 72 73 65 29 3b 0a  etVdbe(pParse);.
2410: 20 20 20 20 73 71 6c 69 74 65 33 43 68 61 6e 67      sqlite3Chang
2420: 65 43 6f 6f 6b 69 65 28 64 62 2c 20 76 2c 20 69  eCookie(db, v, i
2430: 44 62 29 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65  Db);..    sqlite
2440: 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50  3VdbeAddOp(v, OP
2450: 5f 45 78 70 69 72 65 2c 20 30 2c 20 30 29 3b 0a  _Expire, 0, 0);.
2460: 20 20 20 20 7a 57 68 65 72 65 20 3d 20 73 71 6c      zWhere = sql
2470: 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c 20  ite3MPrintf(db, 
2480: 22 6e 61 6d 65 3d 27 25 71 27 22 2c 20 70 54 61  "name='%q'", pTa
2490: 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 73  b->zName);.    s
24a0: 71 6c 69 74 65 33 56 64 62 65 4f 70 33 28 76 2c  qlite3VdbeOp3(v,
24b0: 20 4f 50 5f 50 61 72 73 65 53 63 68 65 6d 61 2c   OP_ParseSchema,
24c0: 20 69 44 62 2c 20 31 2c 20 7a 57 68 65 72 65 2c   iDb, 1, zWhere,
24d0: 20 50 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20   P3_DYNAMIC);.  
24e0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4f 70 33    sqlite3VdbeOp3
24f0: 28 76 2c 20 4f 50 5f 56 43 72 65 61 74 65 2c 20  (v, OP_VCreate, 
2500: 69 44 62 2c 20 30 2c 20 70 54 61 62 2d 3e 7a 4e  iDb, 0, pTab->zN
2510: 61 6d 65 2c 20 73 74 72 6c 65 6e 28 70 54 61 62  ame, strlen(pTab
2520: 2d 3e 7a 4e 61 6d 65 29 20 2b 20 31 29 3b 0a 20  ->zName) + 1);. 
2530: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 61   }..  /* If we a
2540: 72 65 20 72 65 72 65 61 64 69 6e 67 20 74 68 65  re rereading the
2550: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74   sqlite_master t
2560: 61 62 6c 65 20 63 72 65 61 74 65 20 74 68 65 20  able create the 
2570: 69 6e 2d 6d 65 6d 6f 72 79 0a 20 20 2a 2a 20 72  in-memory.  ** r
2580: 65 63 6f 72 64 20 6f 66 20 74 68 65 20 74 61 62  ecord of the tab
2590: 6c 65 2e 20 49 66 20 74 68 65 20 6d 6f 64 75 6c  le. If the modul
25a0: 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65  e has already be
25b0: 65 6e 20 72 65 67 69 73 74 65 72 65 64 2c 0a 20  en registered,. 
25c0: 20 2a 2a 20 61 6c 73 6f 20 63 61 6c 6c 20 74 68   ** also call th
25d0: 65 20 78 43 6f 6e 6e 65 63 74 20 6d 65 74 68 6f  e xConnect metho
25e0: 64 20 68 65 72 65 2e 0a 20 20 2a 2f 0a 20 20 65  d here..  */.  e
25f0: 6c 73 65 20 7b 0a 20 20 20 20 54 61 62 6c 65 20  lse {.    Table 
2600: 2a 70 4f 6c 64 3b 0a 20 20 20 20 53 63 68 65 6d  *pOld;.    Schem
2610: 61 20 2a 70 53 63 68 65 6d 61 20 3d 20 70 54 61  a *pSchema = pTa
2620: 62 2d 3e 70 53 63 68 65 6d 61 3b 0a 20 20 20 20  b->pSchema;.    
2630: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
2640: 65 20 3d 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 3b  e = pTab->zName;
2650: 0a 20 20 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d  .    int nName =
2660: 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 20 2b   strlen(zName) +
2670: 20 31 3b 0a 20 20 20 20 70 4f 6c 64 20 3d 20 73   1;.    pOld = s
2680: 71 6c 69 74 65 33 48 61 73 68 49 6e 73 65 72 74  qlite3HashInsert
2690: 28 26 70 53 63 68 65 6d 61 2d 3e 74 62 6c 48 61  (&pSchema->tblHa
26a0: 73 68 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65  sh, zName, nName
26b0: 2c 20 70 54 61 62 29 3b 0a 20 20 20 20 69 66 28  , pTab);.    if(
26c0: 20 70 4f 6c 64 20 29 7b 0a 20 20 20 20 20 20 64   pOld ){.      d
26d0: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
26e0: 3d 20 31 3b 0a 20 20 20 20 20 20 61 73 73 65 72  = 1;.      asser
26f0: 74 28 20 70 54 61 62 3d 3d 70 4f 6c 64 20 29 3b  t( pTab==pOld );
2700: 20 20 2f 2a 20 4d 61 6c 6c 6f 63 20 6d 75 73 74    /* Malloc must
2710: 20 68 61 76 65 20 66 61 69 6c 65 64 20 69 6e 73   have failed ins
2720: 69 64 65 20 48 61 73 68 49 6e 73 65 72 74 28 29  ide HashInsert()
2730: 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e   */.      return
2740: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 53 63 68  ;.    }.    pSch
2750: 65 6d 61 2d 3e 64 62 20 3d 20 70 50 61 72 73 65  ema->db = pParse
2760: 2d 3e 64 62 3b 0a 20 20 20 20 70 50 61 72 73 65  ->db;.    pParse
2770: 2d 3e 70 4e 65 77 54 61 62 6c 65 20 3d 20 30 3b  ->pNewTable = 0;
2780: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  .  }.}../*.** Th
2790: 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73 20 74  e parser calls t
27a0: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e  his routine when
27b0: 20 69 74 20 73 65 65 73 20 74 68 65 20 66 69 72   it sees the fir
27c0: 73 74 20 74 6f 6b 65 6e 0a 2a 2a 20 6f 66 20 61  st token.** of a
27d0: 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68  n argument to th
27e0: 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 69 6e  e module name in
27f0: 20 61 20 43 52 45 41 54 45 20 56 49 52 54 55 41   a CREATE VIRTUA
2800: 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e  L TABLE statemen
2810: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
2820: 65 33 56 74 61 62 41 72 67 49 6e 69 74 28 50 61  e3VtabArgInit(Pa
2830: 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20 20  rse *pParse){.  
2840: 61 64 64 41 72 67 75 6d 65 6e 74 54 6f 56 74 61  addArgumentToVta
2850: 62 28 70 50 61 72 73 65 29 3b 0a 20 20 70 50 61  b(pParse);.  pPa
2860: 72 73 65 2d 3e 73 41 72 67 2e 7a 20 3d 20 30 3b  rse->sArg.z = 0;
2870: 0a 20 20 70 50 61 72 73 65 2d 3e 73 41 72 67 2e  .  pParse->sArg.
2880: 6e 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n = 0;.}../*.** 
2890: 54 68 65 20 70 61 72 73 65 72 20 63 61 6c 6c 73  The parser calls
28a0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 66 6f   this routine fo
28b0: 72 20 65 61 63 68 20 74 6f 6b 65 6e 20 61 66 74  r each token aft
28c0: 65 72 20 74 68 65 20 66 69 72 73 74 20 74 6f 6b  er the first tok
28d0: 65 6e 0a 2a 2a 20 69 6e 20 61 6e 20 61 72 67 75  en.** in an argu
28e0: 6d 65 6e 74 20 74 6f 20 74 68 65 20 6d 6f 64 75  ment to the modu
28f0: 6c 65 20 6e 61 6d 65 20 69 6e 20 61 20 43 52 45  le name in a CRE
2900: 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c  ATE VIRTUAL TABL
2910: 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a  E statement..*/.
2920: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62  void sqlite3Vtab
2930: 41 72 67 45 78 74 65 6e 64 28 50 61 72 73 65 20  ArgExtend(Parse 
2940: 2a 70 50 61 72 73 65 2c 20 54 6f 6b 65 6e 20 2a  *pParse, Token *
2950: 70 29 7b 0a 20 20 54 6f 6b 65 6e 20 2a 70 41 72  p){.  Token *pAr
2960: 67 20 3d 20 26 70 50 61 72 73 65 2d 3e 73 41 72  g = &pParse->sAr
2970: 67 3b 0a 20 20 69 66 28 20 70 41 72 67 2d 3e 7a  g;.  if( pArg->z
2980: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 41 72 67 2d  ==0 ){.    pArg-
2990: 3e 7a 20 3d 20 70 2d 3e 7a 3b 0a 20 20 20 20 70  >z = p->z;.    p
29a0: 41 72 67 2d 3e 6e 20 3d 20 70 2d 3e 6e 3b 0a 20  Arg->n = p->n;. 
29b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65   }else{.    asse
29c0: 72 74 28 70 41 72 67 2d 3e 7a 20 3c 20 70 2d 3e  rt(pArg->z < p->
29d0: 7a 29 3b 0a 20 20 20 20 70 41 72 67 2d 3e 6e 20  z);.    pArg->n 
29e0: 3d 20 28 70 2d 3e 7a 20 2b 20 70 2d 3e 6e 20 2d  = (p->z + p->n -
29f0: 20 70 41 72 67 2d 3e 7a 29 3b 0a 20 20 7d 0a 7d   pArg->z);.  }.}
2a00: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 61  ../*.** Invoke a
2a10: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63   virtual table c
2a20: 6f 6e 73 74 72 75 63 74 6f 72 20 28 65 69 74 68  onstructor (eith
2a30: 65 72 20 78 43 72 65 61 74 65 20 6f 72 20 78 43  er xCreate or xC
2a40: 6f 6e 6e 65 63 74 29 2e 20 54 68 65 0a 2a 2a 20  onnect). The.** 
2a50: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 66  pointer to the f
2a60: 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b  unction to invok
2a70: 65 20 69 73 20 70 61 73 73 65 64 20 61 73 20 74  e is passed as t
2a80: 68 65 20 66 6f 75 72 74 68 20 70 61 72 61 6d 65  he fourth parame
2a90: 74 65 72 0a 2a 2a 20 74 6f 20 74 68 69 73 20 70  ter.** to this p
2aa0: 72 6f 63 65 64 75 72 65 2e 0a 2a 2f 0a 73 74 61  rocedure..*/.sta
2ab0: 74 69 63 20 69 6e 74 20 76 74 61 62 43 61 6c 6c  tic int vtabCall
2ac0: 43 6f 6e 73 74 72 75 63 74 6f 72 28 0a 20 20 73  Constructor(.  s
2ad0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 54  qlite3 *db, .  T
2ae0: 61 62 6c 65 20 2a 70 54 61 62 2c 0a 20 20 4d 6f  able *pTab,.  Mo
2af0: 64 75 6c 65 20 2a 70 4d 6f 64 2c 0a 20 20 69 6e  dule *pMod,.  in
2b00: 74 20 28 2a 78 43 6f 6e 73 74 72 75 63 74 29 28  t (*xConstruct)(
2b10: 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69  sqlite3*,void*,i
2b20: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 63 6f  nt,const char*co
2b30: 6e 73 74 2a 2c 73 71 6c 69 74 65 33 5f 76 74 61  nst*,sqlite3_vta
2b40: 62 2a 2a 2c 63 68 61 72 2a 2a 29 2c 0a 20 20 63  b**,char**),.  c
2b50: 68 61 72 20 2a 2a 70 7a 45 72 72 0a 29 7b 0a 20  har **pzErr.){. 
2b60: 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 72   int rc;.  int r
2b70: 63 32 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74  c2;.  sqlite3_vt
2b80: 61 62 20 2a 70 56 74 61 62 3b 0a 20 20 63 6f 6e  ab *pVtab;.  con
2b90: 73 74 20 63 68 61 72 20 2a 63 6f 6e 73 74 2a 61  st char *const*a
2ba0: 7a 41 72 67 20 3d 20 28 63 6f 6e 73 74 20 63 68  zArg = (const ch
2bb0: 61 72 20 2a 63 6f 6e 73 74 2a 29 70 54 61 62 2d  ar *const*)pTab-
2bc0: 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20  >azModuleArg;.  
2bd0: 69 6e 74 20 6e 41 72 67 20 3d 20 70 54 61 62 2d  int nArg = pTab-
2be0: 3e 6e 4d 6f 64 75 6c 65 41 72 67 3b 0a 20 20 63  >nModuleArg;.  c
2bf0: 68 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20  har *zErr = 0;. 
2c00: 20 63 68 61 72 20 2a 7a 4d 6f 64 75 6c 65 4e 61   char *zModuleNa
2c10: 6d 65 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69  me = sqlite3MPri
2c20: 6e 74 66 28 64 62 2c 20 22 25 73 22 2c 20 70 54  ntf(db, "%s", pT
2c30: 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 0a 20 20 69  ab->zName);..  i
2c40: 66 28 20 21 7a 4d 6f 64 75 6c 65 4e 61 6d 65 20  f( !zModuleName 
2c50: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
2c60: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
2c70: 0a 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e  .  assert( !db->
2c80: 70 56 54 61 62 20 29 3b 0a 20 20 61 73 73 65 72  pVTab );.  asser
2c90: 74 28 20 78 43 6f 6e 73 74 72 75 63 74 20 29 3b  t( xConstruct );
2ca0: 0a 0a 20 20 64 62 2d 3e 70 56 54 61 62 20 3d 20  ..  db->pVTab = 
2cb0: 70 54 61 62 3b 0a 20 20 72 63 20 3d 20 73 71 6c  pTab;.  rc = sql
2cc0: 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62  ite3SafetyOff(db
2cd0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d  );.  assert( rc=
2ce0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20  =SQLITE_OK );.  
2cf0: 72 63 20 3d 20 78 43 6f 6e 73 74 72 75 63 74 28  rc = xConstruct(
2d00: 64 62 2c 20 70 4d 6f 64 2d 3e 70 41 75 78 2c 20  db, pMod->pAux, 
2d10: 6e 41 72 67 2c 20 61 7a 41 72 67 2c 20 26 70 54  nArg, azArg, &pT
2d20: 61 62 2d 3e 70 56 74 61 62 2c 20 26 7a 45 72 72  ab->pVtab, &zErr
2d30: 29 3b 0a 20 20 72 63 32 20 3d 20 73 71 6c 69 74  );.  rc2 = sqlit
2d40: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a  e3SafetyOn(db);.
2d50: 20 20 70 56 74 61 62 20 3d 20 70 54 61 62 2d 3e    pVtab = pTab->
2d60: 70 56 74 61 62 3b 0a 20 20 69 66 28 20 72 63 3d  pVtab;.  if( rc=
2d70: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 56  =SQLITE_OK && pV
2d80: 74 61 62 20 29 7b 0a 20 20 20 20 70 56 74 61 62  tab ){.    pVtab
2d90: 2d 3e 70 4d 6f 64 75 6c 65 20 3d 20 70 4d 6f 64  ->pModule = pMod
2da0: 2d 3e 70 4d 6f 64 75 6c 65 3b 0a 20 20 20 20 70  ->pModule;.    p
2db0: 56 74 61 62 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a  Vtab->nRef = 1;.
2dc0: 20 20 7d 0a 0a 20 20 69 66 28 20 53 51 4c 49 54    }..  if( SQLIT
2dd0: 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20  E_OK!=rc ){.    
2de0: 69 66 28 20 7a 45 72 72 3d 3d 30 20 29 7b 0a 20  if( zErr==0 ){. 
2df0: 20 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71       *pzErr = sq
2e00: 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c  lite3MPrintf(db,
2e10: 20 22 76 74 61 62 6c 65 20 63 6f 6e 73 74 72 75   "vtable constru
2e20: 63 74 6f 72 20 66 61 69 6c 65 64 3a 20 25 73 22  ctor failed: %s"
2e30: 2c 20 7a 4d 6f 64 75 6c 65 4e 61 6d 65 29 3b 0a  , zModuleName);.
2e40: 20 20 20 20 7d 65 6c 73 65 20 7b 0a 20 20 20 20      }else {.    
2e50: 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74    *pzErr = sqlit
2e60: 65 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 25  e3MPrintf(db, "%
2e70: 73 22 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20  s", zErr);.     
2e80: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45   sqlite3_free(zE
2e90: 72 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c  rr);.    }.  }el
2ea0: 73 65 20 69 66 28 20 64 62 2d 3e 70 56 54 61 62  se if( db->pVTab
2eb0: 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68   ){.    const ch
2ec0: 61 72 20 2a 7a 46 6f 72 6d 61 74 20 3d 20 22 76  ar *zFormat = "v
2ed0: 74 61 62 6c 65 20 63 6f 6e 73 74 72 75 63 74 6f  table constructo
2ee0: 72 20 64 69 64 20 6e 6f 74 20 64 65 63 6c 61 72  r did not declar
2ef0: 65 20 73 63 68 65 6d 61 3a 20 25 73 22 3b 0a 20  e schema: %s";. 
2f00: 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69     *pzErr = sqli
2f10: 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 7a  te3MPrintf(db, z
2f20: 46 6f 72 6d 61 74 2c 20 70 54 61 62 2d 3e 7a 4e  Format, pTab->zN
2f30: 61 6d 65 29 3b 0a 20 20 20 20 72 63 20 3d 20 53  ame);.    rc = S
2f40: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
2f50: 20 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49   .  if( rc==SQLI
2f60: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20  TE_OK ){.    rc 
2f70: 3d 20 72 63 32 3b 0a 20 20 7d 0a 20 20 64 62 2d  = rc2;.  }.  db-
2f80: 3e 70 56 54 61 62 20 3d 20 30 3b 0a 20 20 73 71  >pVTab = 0;.  sq
2f90: 6c 69 74 65 33 5f 66 72 65 65 28 7a 4d 6f 64 75  lite3_free(zModu
2fa0: 6c 65 4e 61 6d 65 29 3b 0a 0a 20 20 2f 2a 20 49  leName);..  /* I
2fb0: 66 20 65 76 65 72 79 74 68 69 6e 67 20 77 65 6e  f everything wen
2fc0: 74 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 70  t according to p
2fd0: 6c 61 6e 2c 20 6c 6f 6f 70 20 74 68 72 6f 75 67  lan, loop throug
2fe0: 68 20 74 68 65 20 63 6f 6c 75 6d 6e 73 0a 20 20  h the columns.  
2ff0: 2a 2a 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ** of the table 
3000: 74 6f 20 73 65 65 20 69 66 20 61 6e 79 20 6f 66  to see if any of
3010: 20 74 68 65 6d 20 63 6f 6e 74 61 69 6e 20 74 68   them contain th
3020: 65 20 74 6f 6b 65 6e 20 22 68 69 64 64 65 6e 22  e token "hidden"
3030: 2e 0a 20 20 2a 2a 20 49 66 20 73 6f 2c 20 73 65  ..  ** If so, se
3040: 74 20 74 68 65 20 43 6f 6c 75 6d 6e 2e 69 73 48  t the Column.isH
3050: 69 64 64 65 6e 20 66 6c 61 67 20 61 6e 64 20 72  idden flag and r
3060: 65 6d 6f 76 65 20 74 68 65 20 74 6f 6b 65 6e 20  emove the token 
3070: 66 72 6f 6d 0a 20 20 2a 2a 20 74 68 65 20 74 79  from.  ** the ty
3080: 70 65 20 73 74 72 69 6e 67 2e 0a 20 20 2a 2f 0a  pe string..  */.
3090: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
30a0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 6e 74 20 69  _OK ){.    int i
30b0: 43 6f 6c 3b 0a 20 20 20 20 66 6f 72 28 69 43 6f  Col;.    for(iCo
30c0: 6c 3d 30 3b 20 69 43 6f 6c 3c 70 54 61 62 2d 3e  l=0; iCol<pTab->
30d0: 6e 43 6f 6c 3b 20 69 43 6f 6c 2b 2b 29 7b 0a 20  nCol; iCol++){. 
30e0: 20 20 20 20 20 63 68 61 72 20 2a 7a 54 79 70 65       char *zType
30f0: 20 3d 20 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43   = pTab->aCol[iC
3100: 6f 6c 5d 2e 7a 54 79 70 65 3b 0a 20 20 20 20 20  ol].zType;.     
3110: 20 69 6e 74 20 6e 54 79 70 65 3b 0a 20 20 20 20   int nType;.    
3120: 20 20 69 6e 74 20 69 20 3d 20 30 3b 0a 20 20 20    int i = 0;.   
3130: 20 20 20 69 66 28 20 21 7a 54 79 70 65 20 29 20     if( !zType ) 
3140: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20  continue;.      
3150: 6e 54 79 70 65 20 3d 20 73 74 72 6c 65 6e 28 7a  nType = strlen(z
3160: 54 79 70 65 29 3b 0a 20 20 20 20 20 20 69 66 28  Type);.      if(
3170: 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70   sqlite3StrNICmp
3180: 28 22 68 69 64 64 65 6e 22 2c 20 7a 54 79 70 65  ("hidden", zType
3190: 2c 20 36 29 20 7c 7c 20 28 7a 54 79 70 65 5b 36  , 6) || (zType[6
31a0: 5d 20 26 26 20 7a 54 79 70 65 5b 36 5d 21 3d 27  ] && zType[6]!='
31b0: 20 27 29 20 29 7b 0a 20 20 20 20 20 20 20 20 66   ') ){.        f
31c0: 6f 72 28 69 3d 30 3b 20 69 3c 6e 54 79 70 65 3b  or(i=0; i<nType;
31d0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20   i++){.         
31e0: 20 69 66 28 20 28 30 3d 3d 73 71 6c 69 74 65 33   if( (0==sqlite3
31f0: 53 74 72 4e 49 43 6d 70 28 22 20 68 69 64 64 65  StrNICmp(" hidde
3200: 6e 22 2c 20 26 7a 54 79 70 65 5b 69 5d 2c 20 37  n", &zType[i], 7
3210: 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 26 26  )).           &&
3220: 20 28 7a 54 79 70 65 5b 69 2b 37 5d 3d 3d 27 5c   (zType[i+7]=='\
3230: 30 27 20 7c 7c 20 7a 54 79 70 65 5b 69 2b 37 5d  0' || zType[i+7]
3240: 3d 3d 27 20 27 29 0a 20 20 20 20 20 20 20 20 20  ==' ').         
3250: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
3260: 69 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 20  i++;.           
3270: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
3280: 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20    }.        }.  
3290: 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20      }.      if( 
32a0: 69 3c 6e 54 79 70 65 20 29 7b 0a 20 20 20 20 20  i<nType ){.     
32b0: 20 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 20 20     int j;.      
32c0: 20 20 69 6e 74 20 6e 44 65 6c 20 3d 20 36 20 2b    int nDel = 6 +
32d0: 20 28 7a 54 79 70 65 5b 69 2b 36 5d 20 3f 20 31   (zType[i+6] ? 1
32e0: 20 3a 20 30 29 3b 0a 20 20 20 20 20 20 20 20 66   : 0);.        f
32f0: 6f 72 28 6a 3d 69 3b 20 28 6a 2b 6e 44 65 6c 29  or(j=i; (j+nDel)
3300: 3c 3d 6e 54 79 70 65 3b 20 6a 2b 2b 29 7b 0a 20  <=nType; j++){. 
3310: 20 20 20 20 20 20 20 20 20 7a 54 79 70 65 5b 6a           zType[j
3320: 5d 20 3d 20 7a 54 79 70 65 5b 6a 2b 6e 44 65 6c  ] = zType[j+nDel
3330: 5d 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  ];.        }.   
3340: 20 20 20 20 20 69 66 28 20 7a 54 79 70 65 5b 69       if( zType[i
3350: 5d 3d 3d 27 5c 30 27 20 26 26 20 69 3e 30 20 29  ]=='\0' && i>0 )
3360: 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65  {.          asse
3370: 72 74 28 7a 54 79 70 65 5b 69 2d 31 5d 3d 3d 27  rt(zType[i-1]=='
3380: 20 27 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7a   ');.          z
3390: 54 79 70 65 5b 69 2d 31 5d 20 3d 20 27 5c 30 27  Type[i-1] = '\0'
33a0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
33b0: 20 20 20 20 70 54 61 62 2d 3e 61 43 6f 6c 5b 69      pTab->aCol[i
33c0: 43 6f 6c 5d 2e 69 73 48 69 64 64 65 6e 20 3d 20  Col].isHidden = 
33d0: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  1;.      }.    }
33e0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
33f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
3400: 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f  function is invo
3410: 6b 65 64 20 62 79 20 74 68 65 20 70 61 72 73 65  ked by the parse
3420: 72 20 74 6f 20 63 61 6c 6c 20 74 68 65 20 78 43  r to call the xC
3430: 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f 64 0a  onnect() method.
3440: 2a 2a 20 6f 66 20 74 68 65 20 76 69 72 74 75 61  ** of the virtua
3450: 6c 20 74 61 62 6c 65 20 70 54 61 62 2e 20 49 66  l table pTab. If
3460: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
3470: 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  , an error code 
3480: 69 73 20 72 65 74 75 72 6e 65 64 20 0a 2a 2a 20  is returned .** 
3490: 61 6e 64 20 61 6e 20 65 72 72 6f 72 20 6c 65 66  and an error lef
34a0: 74 20 69 6e 20 70 50 61 72 73 65 2e 0a 2a 2a 0a  t in pParse..**.
34b0: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20  ** This call is 
34c0: 61 20 6e 6f 2d 6f 70 20 69 66 20 74 61 62 6c 65  a no-op if table
34d0: 20 70 54 61 62 20 69 73 20 6e 6f 74 20 61 20 76   pTab is not a v
34e0: 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2f  irtual table..*/
34f0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62  .int sqlite3Vtab
3500: 43 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 73  CallConnect(Pars
3510: 65 20 2a 70 50 61 72 73 65 2c 20 54 61 62 6c 65  e *pParse, Table
3520: 20 2a 70 54 61 62 29 7b 0a 20 20 4d 6f 64 75 6c   *pTab){.  Modul
3530: 65 20 2a 70 4d 6f 64 3b 0a 20 20 69 6e 74 20 72  e *pMod;.  int r
3540: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a  c = SQLITE_OK;..
3550: 20 20 69 66 28 20 21 70 54 61 62 20 7c 7c 20 21    if( !pTab || !
3560: 70 54 61 62 2d 3e 69 73 56 69 72 74 75 61 6c 20  pTab->isVirtual 
3570: 7c 7c 20 70 54 61 62 2d 3e 70 56 74 61 62 20 29  || pTab->pVtab )
3580: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
3590: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 70  ITE_OK;.  }..  p
35a0: 4d 6f 64 20 3d 20 70 54 61 62 2d 3e 70 4d 6f 64  Mod = pTab->pMod
35b0: 3b 0a 20 20 69 66 28 20 21 70 4d 6f 64 20 29 7b  ;.  if( !pMod ){
35c0: 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20  .    const char 
35d0: 2a 7a 4d 6f 64 75 6c 65 20 3d 20 70 54 61 62 2d  *zModule = pTab-
35e0: 3e 61 7a 4d 6f 64 75 6c 65 41 72 67 5b 30 5d 3b  >azModuleArg[0];
35f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
3600: 72 4d 73 67 28 70 50 61 72 73 65 2c 20 22 6e 6f  rMsg(pParse, "no
3610: 20 73 75 63 68 20 6d 6f 64 75 6c 65 3a 20 25 73   such module: %s
3620: 22 2c 20 7a 4d 6f 64 75 6c 65 29 3b 0a 20 20 20  ", zModule);.   
3630: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
3640: 4f 52 3b 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20  OR;.  } else {. 
3650: 20 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20     char *zErr = 
3660: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a  0;.    sqlite3 *
3670: 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b  db = pParse->db;
3680: 0a 20 20 20 20 72 63 20 3d 20 76 74 61 62 43 61  .    rc = vtabCa
3690: 6c 6c 43 6f 6e 73 74 72 75 63 74 6f 72 28 64 62  llConstructor(db
36a0: 2c 20 70 54 61 62 2c 20 70 4d 6f 64 2c 20 70 4d  , pTab, pMod, pM
36b0: 6f 64 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 43 6f  od->pModule->xCo
36c0: 6e 6e 65 63 74 2c 20 26 7a 45 72 72 29 3b 0a 20  nnect, &zErr);. 
36d0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
36e0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71  E_OK ){.      sq
36f0: 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28 70 50  lite3ErrorMsg(pP
3700: 61 72 73 65 2c 20 22 25 73 22 2c 20 7a 45 72 72  arse, "%s", zErr
3710: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
3720: 69 74 65 33 5f 66 72 65 65 28 7a 45 72 72 29 3b  ite3_free(zErr);
3730: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72  .  }..  return r
3740: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20  c;.}../*.** Add 
3750: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
3760: 65 20 70 56 74 61 62 20 74 6f 20 74 68 65 20 61  e pVtab to the a
3770: 72 72 61 79 20 73 71 6c 69 74 65 33 2e 61 56 54  rray sqlite3.aVT
3780: 72 61 6e 73 5b 5d 2e 0a 2a 2f 0a 73 74 61 74 69  rans[]..*/.stati
3790: 63 20 69 6e 74 20 61 64 64 54 6f 56 54 72 61 6e  c int addToVTran
37a0: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 73  s(sqlite3 *db, s
37b0: 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74  qlite3_vtab *pVt
37c0: 61 62 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74  ab){.  const int
37d0: 20 41 52 52 41 59 5f 49 4e 43 52 20 3d 20 35 3b   ARRAY_INCR = 5;
37e0: 0a 0a 20 20 2f 2a 20 47 72 6f 77 20 74 68 65 20  ..  /* Grow the 
37f0: 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e 73 20  sqlite3.aVTrans 
3800: 61 72 72 61 79 20 69 66 20 72 65 71 75 69 72 65  array if require
3810: 64 20 2a 2f 0a 20 20 69 66 28 20 28 64 62 2d 3e  d */.  if( (db->
3820: 6e 56 54 72 61 6e 73 25 41 52 52 41 59 5f 49 4e  nVTrans%ARRAY_IN
3830: 43 52 29 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71  CR)==0 ){.    sq
3840: 6c 69 74 65 33 5f 76 74 61 62 20 2a 2a 61 56 54  lite3_vtab **aVT
3850: 72 61 6e 73 3b 0a 20 20 20 20 69 6e 74 20 6e 42  rans;.    int nB
3860: 79 74 65 73 20 3d 20 73 69 7a 65 6f 66 28 73 71  ytes = sizeof(sq
3870: 6c 69 74 65 33 5f 76 74 61 62 20 2a 29 20 2a 20  lite3_vtab *) * 
3880: 28 64 62 2d 3e 6e 56 54 72 61 6e 73 20 2b 20 41  (db->nVTrans + A
3890: 52 52 41 59 5f 49 4e 43 52 29 3b 0a 20 20 20 20  RRAY_INCR);.    
38a0: 61 56 54 72 61 6e 73 20 3d 20 73 71 6c 69 74 65  aVTrans = sqlite
38b0: 33 44 62 52 65 61 6c 6c 6f 63 28 64 62 2c 20 28  3DbRealloc(db, (
38c0: 76 6f 69 64 20 2a 29 64 62 2d 3e 61 56 54 72 61  void *)db->aVTra
38d0: 6e 73 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 20  ns, nBytes);.   
38e0: 20 69 66 28 20 21 61 56 54 72 61 6e 73 20 29 7b   if( !aVTrans ){
38f0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
3900: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
3910: 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 61 56  }.    memset(&aV
3920: 54 72 61 6e 73 5b 64 62 2d 3e 6e 56 54 72 61 6e  Trans[db->nVTran
3930: 73 5d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 71  s], 0, sizeof(sq
3940: 6c 69 74 65 33 5f 76 74 61 62 20 2a 29 2a 41 52  lite3_vtab *)*AR
3950: 52 41 59 5f 49 4e 43 52 29 3b 0a 20 20 20 20 64  RAY_INCR);.    d
3960: 62 2d 3e 61 56 54 72 61 6e 73 20 3d 20 61 56 54  b->aVTrans = aVT
3970: 72 61 6e 73 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  rans;.  }..  /* 
3980: 41 64 64 20 70 56 74 61 62 20 74 6f 20 74 68 65  Add pVtab to the
3990: 20 65 6e 64 20 6f 66 20 73 71 6c 69 74 65 33 2e   end of sqlite3.
39a0: 61 56 54 72 61 6e 73 20 2a 2f 0a 20 20 64 62 2d  aVTrans */.  db-
39b0: 3e 61 56 54 72 61 6e 73 5b 64 62 2d 3e 6e 56 54  >aVTrans[db->nVT
39c0: 72 61 6e 73 2b 2b 5d 20 3d 20 70 56 74 61 62 3b  rans++] = pVtab;
39d0: 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 4c 6f  .  sqlite3VtabLo
39e0: 63 6b 28 70 56 74 61 62 29 3b 0a 20 20 72 65 74  ck(pVtab);.  ret
39f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
3a00: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
3a10: 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64  ction is invoked
3a20: 20 62 79 20 74 68 65 20 76 64 62 65 20 74 6f 20   by the vdbe to 
3a30: 63 61 6c 6c 20 74 68 65 20 78 43 72 65 61 74 65  call the xCreate
3a40: 20 6d 65 74 68 6f 64 0a 2a 2a 20 6f 66 20 74 68   method.** of th
3a50: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20  e virtual table 
3a60: 6e 61 6d 65 64 20 7a 54 61 62 20 69 6e 20 64 61  named zTab in da
3a70: 74 61 62 61 73 65 20 69 44 62 2e 20 0a 2a 2a 0a  tabase iDb. .**.
3a80: 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  ** If an error o
3a90: 63 63 75 72 73 2c 20 2a 70 7a 45 72 72 20 69 73  ccurs, *pzErr is
3aa0: 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 61 6e   set to point an
3ab0: 20 61 6e 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67   an English lang
3ac0: 75 61 67 65 0a 2a 2a 20 64 65 73 63 72 69 70 74  uage.** descript
3ad0: 69 6f 6e 20 6f 66 20 74 68 65 20 65 72 72 6f 72  ion of the error
3ae0: 20 61 6e 64 20 61 6e 20 53 51 4c 49 54 45 5f 58   and an SQLITE_X
3af0: 58 58 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73  XX error code is
3b00: 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 20 49 6e   returned..** In
3b10: 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 63   this case the c
3b20: 61 6c 6c 65 72 20 6d 75 73 74 20 63 61 6c 6c 20  aller must call 
3b30: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 20 6f  sqlite3_free() o
3b40: 6e 20 2a 70 7a 45 72 72 2e 0a 2a 2f 0a 69 6e 74  n *pzErr..*/.int
3b50: 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c   sqlite3VtabCall
3b60: 43 72 65 61 74 65 28 73 71 6c 69 74 65 33 20 2a  Create(sqlite3 *
3b70: 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 6f 6e  db, int iDb, con
3b80: 73 74 20 63 68 61 72 20 2a 7a 54 61 62 2c 20 63  st char *zTab, c
3b90: 68 61 72 20 2a 2a 70 7a 45 72 72 29 7b 0a 20 20  har **pzErr){.  
3ba0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
3bb0: 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61  OK;.  Table *pTa
3bc0: 62 3b 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f  b;.  Module *pMo
3bd0: 64 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  d;.  const char 
3be0: 2a 7a 4d 6f 64 75 6c 65 3b 0a 0a 20 20 70 54 61  *zModule;..  pTa
3bf0: 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54  b = sqlite3FindT
3c00: 61 62 6c 65 28 64 62 2c 20 7a 54 61 62 2c 20 64  able(db, zTab, d
3c10: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d  b->aDb[iDb].zNam
3c20: 65 29 3b 0a 20 20 61 73 73 65 72 74 28 70 54 61  e);.  assert(pTa
3c30: 62 20 26 26 20 70 54 61 62 2d 3e 69 73 56 69 72  b && pTab->isVir
3c40: 74 75 61 6c 20 26 26 20 21 70 54 61 62 2d 3e 70  tual && !pTab->p
3c50: 56 74 61 62 29 3b 0a 20 20 70 4d 6f 64 20 3d 20  Vtab);.  pMod = 
3c60: 70 54 61 62 2d 3e 70 4d 6f 64 3b 0a 20 20 7a 4d  pTab->pMod;.  zM
3c70: 6f 64 75 6c 65 20 3d 20 70 54 61 62 2d 3e 61 7a  odule = pTab->az
3c80: 4d 6f 64 75 6c 65 41 72 67 5b 30 5d 3b 0a 0a 20  ModuleArg[0];.. 
3c90: 20 2f 2a 20 49 66 20 74 68 65 20 6d 6f 64 75 6c   /* If the modul
3ca0: 65 20 68 61 73 20 62 65 65 6e 20 72 65 67 69 73  e has been regis
3cb0: 74 65 72 65 64 20 61 6e 64 20 69 6e 63 6c 75 64  tered and includ
3cc0: 65 73 20 61 20 43 72 65 61 74 65 20 6d 65 74 68  es a Create meth
3cd0: 6f 64 2c 20 0a 20 20 2a 2a 20 69 6e 76 6f 6b 65  od, .  ** invoke
3ce0: 20 69 74 20 6e 6f 77 2e 20 49 66 20 74 68 65 20   it now. If the 
3cf0: 6d 6f 64 75 6c 65 20 68 61 73 20 6e 6f 74 20 62  module has not b
3d00: 65 65 6e 20 72 65 67 69 73 74 65 72 65 64 2c 20  een registered, 
3d10: 72 65 74 75 72 6e 20 61 6e 20 0a 20 20 2a 2a 20  return an .  ** 
3d20: 65 72 72 6f 72 2e 20 4f 74 68 65 72 77 69 73 65  error. Otherwise
3d30: 2c 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0a 20 20  , do nothing..  
3d40: 2a 2f 0a 20 20 69 66 28 20 21 70 4d 6f 64 20 29  */.  if( !pMod )
3d50: 7b 0a 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73  {.    *pzErr = s
3d60: 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62  qlite3MPrintf(db
3d70: 2c 20 22 6e 6f 20 73 75 63 68 20 6d 6f 64 75 6c  , "no such modul
3d80: 65 3a 20 25 73 22 2c 20 7a 4d 6f 64 75 6c 65 29  e: %s", zModule)
3d90: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
3da0: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73 65  E_ERROR;.  }else
3db0: 7b 0a 20 20 20 20 72 63 20 3d 20 76 74 61 62 43  {.    rc = vtabC
3dc0: 61 6c 6c 43 6f 6e 73 74 72 75 63 74 6f 72 28 64  allConstructor(d
3dd0: 62 2c 20 70 54 61 62 2c 20 70 4d 6f 64 2c 20 70  b, pTab, pMod, p
3de0: 4d 6f 64 2d 3e 70 4d 6f 64 75 6c 65 2d 3e 78 43  Mod->pModule->xC
3df0: 72 65 61 74 65 2c 20 70 7a 45 72 72 29 3b 0a 20  reate, pzErr);. 
3e00: 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51   }..  if( rc==SQ
3e10: 4c 49 54 45 5f 4f 4b 20 26 26 20 70 54 61 62 2d  LITE_OK && pTab-
3e20: 3e 70 56 74 61 62 20 29 7b 0a 20 20 20 20 20 20  >pVtab ){.      
3e30: 72 63 20 3d 20 61 64 64 54 6f 56 54 72 61 6e 73  rc = addToVTrans
3e40: 28 64 62 2c 20 70 54 61 62 2d 3e 70 56 74 61 62  (db, pTab->pVtab
3e50: 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e  );.  }..  return
3e60: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
3e70: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75  is function is u
3e80: 73 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 73  sed to set the s
3e90: 63 68 65 6d 61 20 6f 66 20 61 20 76 69 72 74 75  chema of a virtu
3ea0: 61 6c 20 74 61 62 6c 65 2e 20 20 49 74 20 69 73  al table.  It is
3eb0: 20 6f 6e 6c 79 0a 2a 2a 20 76 61 6c 69 64 20 74   only.** valid t
3ec0: 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63  o call this func
3ed0: 74 69 6f 6e 20 66 72 6f 6d 20 77 69 74 68 69 6e  tion from within
3ee0: 20 74 68 65 20 78 43 72 65 61 74 65 28 29 20 6f   the xCreate() o
3ef0: 72 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f 66 20  r xConnect() of 
3f00: 61 0a 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 62  a.** virtual tab
3f10: 6c 65 20 6d 6f 64 75 6c 65 2e 0a 2a 2f 0a 69 6e  le module..*/.in
3f20: 74 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72  t sqlite3_declar
3f30: 65 5f 76 74 61 62 28 73 71 6c 69 74 65 33 20 2a  e_vtab(sqlite3 *
3f40: 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  db, const char *
3f50: 7a 43 72 65 61 74 65 54 61 62 6c 65 29 7b 0a 20  zCreateTable){. 
3f60: 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a 0a   Parse sParse;..
3f70: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
3f80: 45 5f 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a 70  E_OK;.  Table *p
3f90: 54 61 62 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72  Tab;.  char *zEr
3fa0: 72 20 3d 20 30 3b 0a 0a 20 20 73 71 6c 69 74 65  r = 0;..  sqlite
3fb0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62  3_mutex_enter(db
3fc0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 54 61 62  ->mutex);.  pTab
3fd0: 20 3d 20 64 62 2d 3e 70 56 54 61 62 3b 0a 20 20   = db->pVTab;.  
3fe0: 69 66 28 20 21 70 54 61 62 20 29 7b 0a 20 20 20  if( !pTab ){.   
3ff0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
4000: 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c  , SQLITE_MISUSE,
4010: 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33   0);.    sqlite3
4020: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d  _mutex_leave(db-
4030: 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74  >mutex);.    ret
4040: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
4050: 45 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  E;.  }.  assert(
4060: 70 54 61 62 2d 3e 69 73 56 69 72 74 75 61 6c 20  pTab->isVirtual 
4070: 26 26 20 70 54 61 62 2d 3e 6e 43 6f 6c 3d 3d 30  && pTab->nCol==0
4080: 20 26 26 20 70 54 61 62 2d 3e 61 43 6f 6c 3d 3d   && pTab->aCol==
4090: 30 29 3b 0a 0a 20 20 6d 65 6d 73 65 74 28 26 73  0);..  memset(&s
40a0: 50 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66  Parse, 0, sizeof
40b0: 28 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72  (Parse));.  sPar
40c0: 73 65 2e 64 65 63 6c 61 72 65 56 74 61 62 20 3d  se.declareVtab =
40d0: 20 31 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20   1;.  sParse.db 
40e0: 3d 20 64 62 3b 0a 0a 20 20 69 66 28 20 0a 20 20  = db;..  if( .  
40f0: 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b 20 3d 3d      SQLITE_OK ==
4100: 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 73 65   sqlite3RunParse
4110: 72 28 26 73 50 61 72 73 65 2c 20 7a 43 72 65 61  r(&sParse, zCrea
4120: 74 65 54 61 62 6c 65 2c 20 26 7a 45 72 72 29 20  teTable, &zErr) 
4130: 26 26 20 0a 20 20 20 20 20 20 73 50 61 72 73 65  && .      sParse
4140: 2e 70 4e 65 77 54 61 62 6c 65 20 26 26 20 0a 20  .pNewTable && . 
4150: 20 20 20 20 20 21 73 50 61 72 73 65 2e 70 4e 65       !sParse.pNe
4160: 77 54 61 62 6c 65 2d 3e 70 53 65 6c 65 63 74 20  wTable->pSelect 
4170: 26 26 20 0a 20 20 20 20 20 20 21 73 50 61 72 73  && .      !sPars
4180: 65 2e 70 4e 65 77 54 61 62 6c 65 2d 3e 69 73 56  e.pNewTable->isV
4190: 69 72 74 75 61 6c 20 0a 20 20 29 7b 0a 20 20 20  irtual .  ){.   
41a0: 20 70 54 61 62 2d 3e 61 43 6f 6c 20 3d 20 73 50   pTab->aCol = sP
41b0: 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65 2d 3e  arse.pNewTable->
41c0: 61 43 6f 6c 3b 0a 20 20 20 20 70 54 61 62 2d 3e  aCol;.    pTab->
41d0: 6e 43 6f 6c 20 3d 20 73 50 61 72 73 65 2e 70 4e  nCol = sParse.pN
41e0: 65 77 54 61 62 6c 65 2d 3e 6e 43 6f 6c 3b 0a 20  ewTable->nCol;. 
41f0: 20 20 20 73 50 61 72 73 65 2e 70 4e 65 77 54 61     sParse.pNewTa
4200: 62 6c 65 2d 3e 6e 43 6f 6c 20 3d 20 30 3b 0a 20  ble->nCol = 0;. 
4210: 20 20 20 73 50 61 72 73 65 2e 70 4e 65 77 54 61     sParse.pNewTa
4220: 62 6c 65 2d 3e 61 43 6f 6c 20 3d 20 30 3b 0a 20  ble->aCol = 0;. 
4230: 20 20 20 64 62 2d 3e 70 56 54 61 62 20 3d 20 30     db->pVTab = 0
4240: 3b 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20  ;.  } else {.   
4250: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
4260: 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20  , SQLITE_ERROR, 
4270: 7a 45 72 72 29 3b 0a 20 20 20 20 73 71 6c 69 74  zErr);.    sqlit
4280: 65 33 5f 66 72 65 65 28 7a 45 72 72 29 3b 0a 20  e3_free(zErr);. 
4290: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45     rc = SQLITE_E
42a0: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 73 50 61 72  RROR;.  }.  sPar
42b0: 73 65 2e 64 65 63 6c 61 72 65 56 74 61 62 20 3d  se.declareVtab =
42c0: 20 30 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66   0;..  sqlite3_f
42d0: 69 6e 61 6c 69 7a 65 28 28 73 71 6c 69 74 65 33  inalize((sqlite3
42e0: 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70 56  _stmt*)sParse.pV
42f0: 64 62 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 44  dbe);.  sqlite3D
4300: 65 6c 65 74 65 54 61 62 6c 65 28 73 50 61 72 73  eleteTable(sPars
4310: 65 2e 70 4e 65 77 54 61 62 6c 65 29 3b 0a 20 20  e.pNewTable);.  
4320: 73 50 61 72 73 65 2e 70 4e 65 77 54 61 62 6c 65  sParse.pNewTable
4330: 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28   = 0;..  assert(
4340: 20 28 72 63 26 30 78 66 66 29 3d 3d 72 63 20 29   (rc&0xff)==rc )
4350: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
4360: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
4370: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  .  sqlite3_mutex
4380: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78  _leave(db->mutex
4390: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
43a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  }../*.** This fu
43b0: 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65  nction is invoke
43c0: 64 20 62 79 20 74 68 65 20 76 64 62 65 20 74 6f  d by the vdbe to
43d0: 20 63 61 6c 6c 20 74 68 65 20 78 44 65 73 74 72   call the xDestr
43e0: 6f 79 20 6d 65 74 68 6f 64 0a 2a 2a 20 6f 66 20  oy method.** of 
43f0: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
4400: 65 20 6e 61 6d 65 64 20 7a 54 61 62 20 69 6e 20  e named zTab in 
4410: 64 61 74 61 62 61 73 65 20 69 44 62 2e 20 54 68  database iDb. Th
4420: 69 73 20 6f 63 63 75 72 73 0a 2a 2a 20 77 68 65  is occurs.** whe
4430: 6e 20 61 20 44 52 4f 50 20 54 41 42 4c 45 20 69  n a DROP TABLE i
4440: 73 20 6d 65 6e 74 69 6f 6e 65 64 2e 0a 2a 2a 0a  s mentioned..**.
4450: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20  ** This call is 
4460: 61 20 6e 6f 2d 6f 70 20 69 66 20 7a 54 61 62 20  a no-op if zTab 
4470: 69 73 20 6e 6f 74 20 61 20 76 69 72 74 75 61 6c  is not a virtual
4480: 20 74 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73   table..*/.int s
4490: 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 44 65  qlite3VtabCallDe
44a0: 73 74 72 6f 79 28 73 71 6c 69 74 65 33 20 2a 64  stroy(sqlite3 *d
44b0: 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 6f 6e 73  b, int iDb, cons
44c0: 74 20 63 68 61 72 20 2a 7a 54 61 62 29 0a 7b 0a  t char *zTab).{.
44d0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
44e0: 45 5f 4f 4b 3b 0a 20 20 54 61 62 6c 65 20 2a 70  E_OK;.  Table *p
44f0: 54 61 62 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73  Tab;..  pTab = s
4500: 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28  qlite3FindTable(
4510: 64 62 2c 20 7a 54 61 62 2c 20 64 62 2d 3e 61 44  db, zTab, db->aD
4520: 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 3b 0a 20  b[iDb].zName);. 
4530: 20 61 73 73 65 72 74 28 70 54 61 62 29 3b 0a 20   assert(pTab);. 
4540: 20 69 66 28 20 70 54 61 62 2d 3e 70 56 74 61 62   if( pTab->pVtab
4550: 20 29 7b 0a 20 20 20 20 69 6e 74 20 28 2a 78 44   ){.    int (*xD
4560: 65 73 74 72 6f 79 29 28 73 71 6c 69 74 65 33 5f  estroy)(sqlite3_
4570: 76 74 61 62 20 2a 70 56 54 61 62 29 20 3d 20 70  vtab *pVTab) = p
4580: 54 61 62 2d 3e 70 4d 6f 64 2d 3e 70 4d 6f 64 75  Tab->pMod->pModu
4590: 6c 65 2d 3e 78 44 65 73 74 72 6f 79 3b 0a 20 20  le->xDestroy;.  
45a0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 53 61    rc = sqlite3Sa
45b0: 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 20  fetyOff(db);.   
45c0: 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c   assert( rc==SQL
45d0: 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 69 66  ITE_OK );.    if
45e0: 28 20 78 44 65 73 74 72 6f 79 20 29 7b 0a 20 20  ( xDestroy ){.  
45f0: 20 20 20 20 72 63 20 3d 20 78 44 65 73 74 72 6f      rc = xDestro
4600: 79 28 70 54 61 62 2d 3e 70 56 74 61 62 29 3b 0a  y(pTab->pVtab);.
4610: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
4620: 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20  3SafetyOn(db);. 
4630: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
4640: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 54  E_OK ){.      pT
4650: 61 62 2d 3e 70 56 74 61 62 20 3d 20 30 3b 0a 20  ab->pVtab = 0;. 
4660: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75     }.  }..  retu
4670: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
4680: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 6e  This function in
4690: 76 6f 6b 65 73 20 65 69 74 68 65 72 20 74 68 65  vokes either the
46a0: 20 78 52 6f 6c 6c 62 61 63 6b 20 6f 72 20 78 43   xRollback or xC
46b0: 6f 6d 6d 69 74 20 6d 65 74 68 6f 64 0a 2a 2a 20  ommit method.** 
46c0: 6f 66 20 65 61 63 68 20 6f 66 20 74 68 65 20 76  of each of the v
46d0: 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e  irtual tables in
46e0: 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 56 54   the sqlite3.aVT
46f0: 72 61 6e 73 20 61 72 72 61 79 2e 20 54 68 65 20  rans array. The 
4700: 6d 65 74 68 6f 64 0a 2a 2a 20 63 61 6c 6c 65 64  method.** called
4710: 20 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 62   is identified b
4720: 79 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67  y the second arg
4730: 75 6d 65 6e 74 2c 20 22 6f 66 66 73 65 74 22 2c  ument, "offset",
4740: 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 74 68 65   which is.** the
4750: 20 6f 66 66 73 65 74 20 6f 66 20 74 68 65 20 6d   offset of the m
4760: 65 74 68 6f 64 20 74 6f 20 63 61 6c 6c 20 69 6e  ethod to call in
4770: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6d 6f 64   the sqlite3_mod
4780: 75 6c 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  ule structure..*
4790: 2a 0a 2a 2a 20 54 68 65 20 61 72 72 61 79 20 69  *.** The array i
47a0: 73 20 63 6c 65 61 72 65 64 20 61 66 74 65 72 20  s cleared after 
47b0: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 61 6c  invoking the cal
47c0: 6c 62 61 63 6b 73 2e 20 0a 2a 2f 0a 73 74 61 74  lbacks. .*/.stat
47d0: 69 63 20 76 6f 69 64 20 63 61 6c 6c 46 69 6e 61  ic void callFina
47e0: 6c 69 73 65 72 28 73 71 6c 69 74 65 33 20 2a 64  liser(sqlite3 *d
47f0: 62 2c 20 69 6e 74 20 6f 66 66 73 65 74 29 7b 0a  b, int offset){.
4800: 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 64    int i;.  if( d
4810: 62 2d 3e 61 56 54 72 61 6e 73 20 29 7b 0a 20 20  b->aVTrans ){.  
4820: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
4830: 3e 6e 56 54 72 61 6e 73 20 26 26 20 64 62 2d 3e  >nVTrans && db->
4840: 61 56 54 72 61 6e 73 5b 69 5d 3b 20 69 2b 2b 29  aVTrans[i]; i++)
4850: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
4860: 76 74 61 62 20 2a 70 56 74 61 62 20 3d 20 64 62  vtab *pVtab = db
4870: 2d 3e 61 56 54 72 61 6e 73 5b 69 5d 3b 0a 20 20  ->aVTrans[i];.  
4880: 20 20 20 20 69 6e 74 20 28 2a 78 29 28 73 71 6c      int (*x)(sql
4890: 69 74 65 33 5f 76 74 61 62 20 2a 29 3b 0a 20 20  ite3_vtab *);.  
48a0: 20 20 20 20 78 20 3d 20 2a 28 69 6e 74 20 28 2a      x = *(int (*
48b0: 2a 29 28 73 71 6c 69 74 65 33 5f 76 74 61 62 20  *)(sqlite3_vtab 
48c0: 2a 29 29 28 28 63 68 61 72 20 2a 29 70 56 74 61  *))((char *)pVta
48d0: 62 2d 3e 70 4d 6f 64 75 6c 65 20 2b 20 6f 66 66  b->pModule + off
48e0: 73 65 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20  set);.      if( 
48f0: 78 20 29 20 78 28 70 56 74 61 62 29 3b 0a 20 20  x ) x(pVtab);.  
4900: 20 20 20 20 73 71 6c 69 74 65 33 56 74 61 62 55      sqlite3VtabU
4910: 6e 6c 6f 63 6b 28 64 62 2c 20 70 56 74 61 62 29  nlock(db, pVtab)
4920: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
4930: 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 61 56 54  te3_free(db->aVT
4940: 72 61 6e 73 29 3b 0a 20 20 20 20 64 62 2d 3e 6e  rans);.    db->n
4950: 56 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20  VTrans = 0;.    
4960: 64 62 2d 3e 61 56 54 72 61 6e 73 20 3d 20 30 3b  db->aVTrans = 0;
4970: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66  .  }.}../*.** If
4980: 20 61 72 67 75 6d 65 6e 74 20 72 63 32 20 69 73   argument rc2 is
4990: 20 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b 2c 20   not SQLITE_OK, 
49a0: 74 68 65 6e 20 72 65 74 75 72 6e 20 69 74 20 61  then return it a
49b0: 6e 64 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 20 0a  nd do nothing. .
49c0: 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 6e  ** Otherwise, in
49d0: 76 6f 6b 65 20 74 68 65 20 78 53 79 6e 63 20 6d  voke the xSync m
49e0: 65 74 68 6f 64 20 6f 66 20 61 6c 6c 20 76 69 72  ethod of all vir
49f0: 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 20 74  tual tables in t
4a00: 68 65 20 0a 2a 2a 20 73 71 6c 69 74 65 33 2e 61  he .** sqlite3.a
4a10: 56 54 72 61 6e 73 20 61 72 72 61 79 2e 20 52 65  VTrans array. Re
4a20: 74 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 63  turn the error c
4a30: 6f 64 65 20 66 6f 72 20 74 68 65 20 66 69 72 73  ode for the firs
4a40: 74 20 65 72 72 6f 72 20 0a 2a 2a 20 74 68 61 74  t error .** that
4a50: 20 6f 63 63 75 72 73 2c 20 6f 72 20 53 51 4c 49   occurs, or SQLI
4a60: 54 45 5f 4f 4b 20 69 66 20 61 6c 6c 20 78 53 79  TE_OK if all xSy
4a70: 6e 63 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 72  nc operations ar
4a80: 65 20 73 75 63 63 65 73 73 66 75 6c 2e 0a 2a 2f  e successful..*/
4a90: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62  .int sqlite3Vtab
4aa0: 53 79 6e 63 28 73 71 6c 69 74 65 33 20 2a 64 62  Sync(sqlite3 *db
4ab0: 2c 20 69 6e 74 20 72 63 32 29 7b 0a 20 20 69 6e  , int rc2){.  in
4ac0: 74 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  t i;.  int rc = 
4ad0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74  SQLITE_OK;.  int
4ae0: 20 72 63 73 61 66 65 74 79 3b 0a 20 20 73 71 6c   rcsafety;.  sql
4af0: 69 74 65 33 5f 76 74 61 62 20 2a 2a 61 56 54 72  ite3_vtab **aVTr
4b00: 61 6e 73 20 3d 20 64 62 2d 3e 61 56 54 72 61 6e  ans = db->aVTran
4b10: 73 3b 0a 20 20 69 66 28 20 72 63 32 21 3d 53 51  s;.  if( rc2!=SQ
4b20: 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e  LITE_OK ) return
4b30: 20 72 63 32 3b 0a 0a 20 20 72 63 20 3d 20 73 71   rc2;..  rc = sq
4b40: 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 64  lite3SafetyOff(d
4b50: 62 29 3b 0a 20 20 64 62 2d 3e 61 56 54 72 61 6e  b);.  db->aVTran
4b60: 73 20 3d 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30  s = 0;.  for(i=0
4b70: 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ; rc==SQLITE_OK 
4b80: 26 26 20 69 3c 64 62 2d 3e 6e 56 54 72 61 6e 73  && i<db->nVTrans
4b90: 20 26 26 20 61 56 54 72 61 6e 73 5b 69 5d 3b 20   && aVTrans[i]; 
4ba0: 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  i++){.    sqlite
4bb0: 33 5f 76 74 61 62 20 2a 70 56 74 61 62 20 3d 20  3_vtab *pVtab = 
4bc0: 61 56 54 72 61 6e 73 5b 69 5d 3b 0a 20 20 20 20  aVTrans[i];.    
4bd0: 69 6e 74 20 28 2a 78 29 28 73 71 6c 69 74 65 33  int (*x)(sqlite3
4be0: 5f 76 74 61 62 20 2a 29 3b 0a 20 20 20 20 78 20  _vtab *);.    x 
4bf0: 3d 20 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c 65  = pVtab->pModule
4c00: 2d 3e 78 53 79 6e 63 3b 0a 20 20 20 20 69 66 28  ->xSync;.    if(
4c10: 20 78 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d   x ){.      rc =
4c20: 20 78 28 70 56 74 61 62 29 3b 0a 20 20 20 20 7d   x(pVtab);.    }
4c30: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 56 54 72 61  .  }.  db->aVTra
4c40: 6e 73 20 3d 20 61 56 54 72 61 6e 73 3b 0a 20 20  ns = aVTrans;.  
4c50: 72 63 73 61 66 65 74 79 20 3d 20 73 71 6c 69 74  rcsafety = sqlit
4c60: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a  e3SafetyOn(db);.
4c70: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
4c80: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d  E_OK ){.    rc =
4c90: 20 72 63 73 61 66 65 74 79 3b 0a 20 20 7d 0a 20   rcsafety;.  }. 
4ca0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
4cb0: 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20  *.** Invoke the 
4cc0: 78 52 6f 6c 6c 62 61 63 6b 20 6d 65 74 68 6f 64  xRollback method
4cd0: 20 6f 66 20 61 6c 6c 20 76 69 72 74 75 61 6c 20   of all virtual 
4ce0: 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20 0a 2a  tables in the .*
4cf0: 2a 20 73 71 6c 69 74 65 33 2e 61 56 54 72 61 6e  * sqlite3.aVTran
4d00: 73 20 61 72 72 61 79 2e 20 54 68 65 6e 20 63 6c  s array. Then cl
4d10: 65 61 72 20 74 68 65 20 61 72 72 61 79 20 69 74  ear the array it
4d20: 73 65 6c 66 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  self..*/.int sql
4d30: 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b  ite3VtabRollback
4d40: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
4d50: 20 63 61 6c 6c 46 69 6e 61 6c 69 73 65 72 28 64   callFinaliser(d
4d60: 62 2c 20 28 69 6e 74 29 28 26 28 28 73 71 6c 69  b, (int)(&((sqli
4d70: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 29 30 29 2d  te3_module *)0)-
4d80: 3e 78 52 6f 6c 6c 62 61 63 6b 29 29 3b 0a 20 20  >xRollback));.  
4d90: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
4da0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b  ;.}../*.** Invok
4db0: 65 20 74 68 65 20 78 43 6f 6d 6d 69 74 20 6d 65  e the xCommit me
4dc0: 74 68 6f 64 20 6f 66 20 61 6c 6c 20 76 69 72 74  thod of all virt
4dd0: 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 20 74 68  ual tables in th
4de0: 65 20 0a 2a 2a 20 73 71 6c 69 74 65 33 2e 61 56  e .** sqlite3.aV
4df0: 54 72 61 6e 73 20 61 72 72 61 79 2e 20 54 68 65  Trans array. The
4e00: 6e 20 63 6c 65 61 72 20 74 68 65 20 61 72 72 61  n clear the arra
4e10: 79 20 69 74 73 65 6c 66 2e 0a 2a 2f 0a 69 6e 74  y itself..*/.int
4e20: 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f 6d 6d   sqlite3VtabComm
4e30: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b  it(sqlite3 *db){
4e40: 0a 20 20 63 61 6c 6c 46 69 6e 61 6c 69 73 65 72  .  callFinaliser
4e50: 28 64 62 2c 20 28 69 6e 74 29 28 26 28 28 73 71  (db, (int)(&((sq
4e60: 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 29 30  lite3_module *)0
4e70: 29 2d 3e 78 43 6f 6d 6d 69 74 29 29 3b 0a 20 20  )->xCommit));.  
4e80: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
4e90: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68  ;.}../*.** If th
4ea0: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20  e virtual table 
4eb0: 70 56 74 61 62 20 73 75 70 70 6f 72 74 73 20 74  pVtab supports t
4ec0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  he transaction i
4ed0: 6e 74 65 72 66 61 63 65 0a 2a 2a 20 28 78 42 65  nterface.** (xBe
4ee0: 67 69 6e 2f 78 52 6f 6c 6c 62 61 63 6b 2f 78 43  gin/xRollback/xC
4ef0: 6f 6d 6d 69 74 20 61 6e 64 20 6f 70 74 69 6f 6e  ommit and option
4f00: 61 6c 6c 79 20 78 53 79 6e 63 29 20 61 6e 64 20  ally xSync) and 
4f10: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  a transaction is
4f20: 0a 2a 2a 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c  .** not currentl
4f30: 79 20 6f 70 65 6e 2c 20 69 6e 76 6f 6b 65 20 74  y open, invoke t
4f40: 68 65 20 78 42 65 67 69 6e 20 6d 65 74 68 6f 64  he xBegin method
4f50: 20 6e 6f 77 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74   now..**.** If t
4f60: 68 65 20 78 42 65 67 69 6e 20 63 61 6c 6c 20 69  he xBegin call i
4f70: 73 20 73 75 63 63 65 73 73 66 75 6c 2c 20 70 6c  s successful, pl
4f80: 61 63 65 20 74 68 65 20 73 71 6c 69 74 65 33 5f  ace the sqlite3_
4f90: 76 74 61 62 20 70 6f 69 6e 74 65 72 0a 2a 2a 20  vtab pointer.** 
4fa0: 69 6e 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61  in the sqlite3.a
4fb0: 56 54 72 61 6e 73 20 61 72 72 61 79 2e 0a 2a 2f  VTrans array..*/
4fc0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62  .int sqlite3Vtab
4fd0: 42 65 67 69 6e 28 73 71 6c 69 74 65 33 20 2a 64  Begin(sqlite3 *d
4fe0: 62 2c 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20  b, sqlite3_vtab 
4ff0: 2a 70 56 74 61 62 29 7b 0a 20 20 69 6e 74 20 72  *pVtab){.  int r
5000: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
5010: 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d   const sqlite3_m
5020: 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 3b 0a  odule *pModule;.
5030: 0a 20 20 2f 2a 20 53 70 65 63 69 61 6c 20 63 61  .  /* Special ca
5040: 73 65 3a 20 49 66 20 64 62 2d 3e 61 56 54 72 61  se: If db->aVTra
5050: 6e 73 20 69 73 20 4e 55 4c 4c 20 61 6e 64 20 64  ns is NULL and d
5060: 62 2d 3e 6e 56 54 72 61 6e 73 20 69 73 20 67 72  b->nVTrans is gr
5070: 65 61 74 65 72 0a 20 20 2a 2a 20 74 68 61 6e 20  eater.  ** than 
5080: 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 69 73 20  zero, then this 
5090: 66 75 6e 63 74 69 6f 6e 20 69 73 20 62 65 69 6e  function is bein
50a0: 67 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69  g called from wi
50b0: 74 68 69 6e 20 61 0a 20 20 2a 2a 20 76 69 72 74  thin a.  ** virt
50c0: 75 61 6c 20 6d 6f 64 75 6c 65 20 78 53 79 6e 63  ual module xSync
50d0: 28 29 20 63 61 6c 6c 62 61 63 6b 2e 20 49 74 20  () callback. It 
50e0: 69 73 20 69 6c 6c 65 67 61 6c 20 74 6f 20 77 72  is illegal to wr
50f0: 69 74 65 20 74 6f 20 0a 20 20 2a 2a 20 76 69 72  ite to .  ** vir
5100: 74 75 61 6c 20 6d 6f 64 75 6c 65 20 74 61 62 6c  tual module tabl
5110: 65 73 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c  es in this case,
5120: 20 73 6f 20 72 65 74 75 72 6e 20 53 51 4c 49 54   so return SQLIT
5130: 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 2a 2f 0a 20  E_LOCKED..  */. 
5140: 20 69 66 28 20 30 3d 3d 64 62 2d 3e 61 56 54 72   if( 0==db->aVTr
5150: 61 6e 73 20 26 26 20 64 62 2d 3e 6e 56 54 72 61  ans && db->nVTra
5160: 6e 73 3e 30 20 29 7b 0a 20 20 20 20 72 65 74 75  ns>0 ){.    retu
5170: 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  rn SQLITE_LOCKED
5180: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 70 56 74  ;.  }.  if( !pVt
5190: 61 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ab ){.    return
51a0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 20   SQLITE_OK;.  } 
51b0: 0a 20 20 70 4d 6f 64 75 6c 65 20 3d 20 70 56 74  .  pModule = pVt
51c0: 61 62 2d 3e 70 4d 6f 64 75 6c 65 3b 0a 0a 20 20  ab->pModule;..  
51d0: 69 66 28 20 70 4d 6f 64 75 6c 65 2d 3e 78 42 65  if( pModule->xBe
51e0: 67 69 6e 20 29 7b 0a 20 20 20 20 69 6e 74 20 69  gin ){.    int i
51f0: 3b 0a 0a 0a 20 20 20 20 2f 2a 20 49 66 20 70 56  ;...    /* If pV
5200: 74 61 62 20 69 73 20 61 6c 72 65 61 64 79 20 69  tab is already i
5210: 6e 20 74 68 65 20 61 56 54 72 61 6e 73 20 61 72  n the aVTrans ar
5220: 72 61 79 2c 20 72 65 74 75 72 6e 20 65 61 72 6c  ray, return earl
5230: 79 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30  y */.    for(i=0
5240: 3b 20 28 69 3c 64 62 2d 3e 6e 56 54 72 61 6e 73  ; (i<db->nVTrans
5250: 29 20 26 26 20 30 21 3d 64 62 2d 3e 61 56 54 72  ) && 0!=db->aVTr
5260: 61 6e 73 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20  ans[i]; i++){.  
5270: 20 20 20 20 69 66 28 20 64 62 2d 3e 61 56 54 72      if( db->aVTr
5280: 61 6e 73 5b 69 5d 3d 3d 70 56 74 61 62 20 29 7b  ans[i]==pVtab ){
5290: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
52a0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20  SQLITE_OK;.     
52b0: 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a   }.    }..    /*
52c0: 20 49 6e 76 6f 6b 65 20 74 68 65 20 78 42 65 67   Invoke the xBeg
52d0: 69 6e 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 20  in method */.   
52e0: 20 72 63 20 3d 20 70 4d 6f 64 75 6c 65 2d 3e 78   rc = pModule->x
52f0: 42 65 67 69 6e 28 70 56 74 61 62 29 3b 0a 20 20  Begin(pVtab);.  
5300: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
5310: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74  _OK ){.      ret
5320: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20  urn rc;.    }.. 
5330: 20 20 20 72 63 20 3d 20 61 64 64 54 6f 56 54 72     rc = addToVTr
5340: 61 6e 73 28 64 62 2c 20 70 56 74 61 62 29 3b 0a  ans(db, pVtab);.
5350: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
5360: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 69  .}../*.** The fi
5370: 72 73 74 20 70 61 72 61 6d 65 74 65 72 20 28 70  rst parameter (p
5380: 44 65 66 29 20 69 73 20 61 20 66 75 6e 63 74 69  Def) is a functi
5390: 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  on implementatio
53a0: 6e 2e 20 20 54 68 65 0a 2a 2a 20 73 65 63 6f 6e  n.  The.** secon
53b0: 64 20 70 61 72 61 6d 65 74 65 72 20 28 70 45 78  d parameter (pEx
53c0: 70 72 29 20 69 73 20 74 68 65 20 66 69 72 73 74  pr) is the first
53d0: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69   argument to thi
53e0: 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 49  s function..** I
53f0: 66 20 70 45 78 70 72 20 69 73 20 61 20 63 6f 6c  f pExpr is a col
5400: 75 6d 6e 20 69 6e 20 61 20 76 69 72 74 75 61 6c  umn in a virtual
5410: 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 6c 65 74   table, then let
5420: 20 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20   the virtual.** 
5430: 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61  table implementa
5440: 74 69 6f 6e 20 68 61 76 65 20 61 6e 20 6f 70 70  tion have an opp
5450: 6f 72 74 75 6e 69 74 79 20 74 6f 20 6f 76 65 72  ortunity to over
5460: 6c 6f 61 64 20 74 68 65 20 66 75 6e 63 74 69 6f  load the functio
5470: 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  n..**.** This ro
5480: 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 74 6f  utine is used to
5490: 20 61 6c 6c 6f 77 20 76 69 72 74 75 61 6c 20 74   allow virtual t
54a0: 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74  able implementat
54b0: 69 6f 6e 73 20 74 6f 0a 2a 2a 20 6f 76 65 72 6c  ions to.** overl
54c0: 6f 61 64 20 4d 41 54 43 48 2c 20 4c 49 4b 45 2c  oad MATCH, LIKE,
54d0: 20 47 4c 4f 42 2c 20 61 6e 64 20 52 45 47 45 58   GLOB, and REGEX
54e0: 50 20 6f 70 65 72 61 74 6f 72 73 2e 0a 2a 2a 0a  P operators..**.
54f0: 2a 2a 20 52 65 74 75 72 6e 20 65 69 74 68 65 72  ** Return either
5500: 20 74 68 65 20 70 44 65 66 20 61 72 67 75 6d 65   the pDef argume
5510: 6e 74 20 28 69 6e 64 69 63 61 74 69 6e 67 20 6e  nt (indicating n
5520: 6f 20 63 68 61 6e 67 65 29 20 6f 72 20 61 20 0a  o change) or a .
5530: 2a 2a 20 6e 65 77 20 46 75 6e 63 44 65 66 20 73  ** new FuncDef s
5540: 74 72 75 63 74 75 72 65 20 74 68 61 74 20 69 73  tructure that is
5550: 20 6d 61 72 6b 65 64 20 61 73 20 65 70 68 65 6d   marked as ephem
5560: 65 72 61 6c 20 75 73 69 6e 67 20 74 68 65 0a 2a  eral using the.*
5570: 2a 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 50  * SQLITE_FUNC_EP
5580: 48 45 4d 20 66 6c 61 67 2e 0a 2a 2f 0a 46 75 6e  HEM flag..*/.Fun
5590: 63 44 65 66 20 2a 73 71 6c 69 74 65 33 56 74 61  cDef *sqlite3Vta
55a0: 62 4f 76 65 72 6c 6f 61 64 46 75 6e 63 74 69 6f  bOverloadFunctio
55b0: 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  n(.  sqlite3 *db
55c0: 2c 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65  ,    /* Database
55d0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 6f 72 20   connection for 
55e0: 72 65 70 6f 72 74 69 6e 67 20 6d 61 6c 6c 6f 63  reporting malloc
55f0: 20 70 72 6f 62 6c 65 6d 73 20 2a 2f 0a 20 20 46   problems */.  F
5600: 75 6e 63 44 65 66 20 2a 70 44 65 66 2c 20 20 2f  uncDef *pDef,  /
5610: 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 70 6f  * Function to po
5620: 73 73 69 62 6c 79 20 6f 76 65 72 6c 6f 61 64 20  ssibly overload 
5630: 2a 2f 0a 20 20 69 6e 74 20 6e 41 72 67 2c 20 20  */.  int nArg,  
5640: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
5650: 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 74  f arguments to t
5660: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20  he function */. 
5670: 20 45 78 70 72 20 2a 70 45 78 70 72 20 20 20 20   Expr *pExpr    
5680: 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65   /* First argume
5690: 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69  nt to the functi
56a0: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 54 61 62 6c 65  on */.){.  Table
56b0: 20 2a 70 54 61 62 3b 0a 20 20 73 71 6c 69 74 65   *pTab;.  sqlite
56c0: 33 5f 76 74 61 62 20 2a 70 56 74 61 62 3b 0a 20  3_vtab *pVtab;. 
56d0: 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20   sqlite3_module 
56e0: 2a 70 4d 6f 64 3b 0a 20 20 76 6f 69 64 20 28 2a  *pMod;.  void (*
56f0: 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63  xFunc)(sqlite3_c
5700: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69  ontext*,int,sqli
5710: 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 20 20  te3_value**);.  
5720: 76 6f 69 64 20 2a 70 41 72 67 3b 0a 20 20 46 75  void *pArg;.  Fu
5730: 6e 63 44 65 66 20 2a 70 4e 65 77 3b 0a 20 20 69  ncDef *pNew;.  i
5740: 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a  nt rc;.  char *z
5750: 4c 6f 77 65 72 4e 61 6d 65 3b 0a 20 20 75 6e 73  LowerName;.  uns
5760: 69 67 6e 65 64 20 63 68 61 72 20 2a 7a 3b 0a 0a  igned char *z;..
5770: 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20 73  .  /* Check to s
5780: 65 65 20 74 68 65 20 6c 65 66 74 20 6f 70 65 72  ee the left oper
5790: 61 6e 64 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20  and is a column 
57a0: 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 62  in a virtual tab
57b0: 6c 65 20 2a 2f 0a 20 20 69 66 28 20 70 45 78 70  le */.  if( pExp
57c0: 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 70 44  r==0 ) return pD
57d0: 65 66 3b 0a 20 20 69 66 28 20 70 45 78 70 72 2d  ef;.  if( pExpr-
57e0: 3e 6f 70 21 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 29  >op!=TK_COLUMN )
57f0: 20 72 65 74 75 72 6e 20 70 44 65 66 3b 0a 20 20   return pDef;.  
5800: 70 54 61 62 20 3d 20 70 45 78 70 72 2d 3e 70 54  pTab = pExpr->pT
5810: 61 62 3b 0a 20 20 69 66 28 20 70 54 61 62 3d 3d  ab;.  if( pTab==
5820: 30 20 29 20 72 65 74 75 72 6e 20 70 44 65 66 3b  0 ) return pDef;
5830: 0a 20 20 69 66 28 20 21 70 54 61 62 2d 3e 69 73  .  if( !pTab->is
5840: 56 69 72 74 75 61 6c 20 29 20 72 65 74 75 72 6e  Virtual ) return
5850: 20 70 44 65 66 3b 0a 20 20 70 56 74 61 62 20 3d   pDef;.  pVtab =
5860: 20 70 54 61 62 2d 3e 70 56 74 61 62 3b 0a 20 20   pTab->pVtab;.  
5870: 61 73 73 65 72 74 28 20 70 56 74 61 62 21 3d 30  assert( pVtab!=0
5880: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56   );.  assert( pV
5890: 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 21 3d 30 20  tab->pModule!=0 
58a0: 29 3b 0a 20 20 70 4d 6f 64 20 3d 20 28 73 71 6c  );.  pMod = (sql
58b0: 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 29 70 56  ite3_module *)pV
58c0: 74 61 62 2d 3e 70 4d 6f 64 75 6c 65 3b 0a 20 20  tab->pModule;.  
58d0: 69 66 28 20 70 4d 6f 64 2d 3e 78 46 69 6e 64 46  if( pMod->xFindF
58e0: 75 6e 63 74 69 6f 6e 3d 3d 30 20 29 20 72 65 74  unction==0 ) ret
58f0: 75 72 6e 20 70 44 65 66 3b 0a 20 0a 20 20 2f 2a  urn pDef;. .  /*
5900: 20 43 61 6c 6c 20 74 68 65 20 78 46 75 6e 63 46   Call the xFuncF
5910: 75 6e 63 74 69 6f 6e 20 6d 65 74 68 6f 64 20 6f  unction method o
5920: 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61  n the virtual ta
5930: 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ble implementati
5940: 6f 6e 0a 20 20 2a 2a 20 74 6f 20 73 65 65 20 69  on.  ** to see i
5950: 66 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61  f the implementa
5960: 74 69 6f 6e 20 77 61 6e 74 73 20 74 6f 20 6f 76  tion wants to ov
5970: 65 72 6c 6f 61 64 20 74 68 69 73 20 66 75 6e 63  erload this func
5980: 74 69 6f 6e 20 0a 20 20 2a 2f 0a 20 20 7a 4c 6f  tion .  */.  zLo
5990: 77 65 72 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65  werName = sqlite
59a0: 33 44 62 53 74 72 44 75 70 28 64 62 2c 20 70 44  3DbStrDup(db, pD
59b0: 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 69 66  ef->zName);.  if
59c0: 28 20 7a 4c 6f 77 65 72 4e 61 6d 65 20 29 7b 0a  ( zLowerName ){.
59d0: 20 20 20 20 66 6f 72 28 7a 3d 28 75 6e 73 69 67      for(z=(unsig
59e0: 6e 65 64 20 63 68 61 72 2a 29 7a 4c 6f 77 65 72  ned char*)zLower
59f0: 4e 61 6d 65 3b 20 2a 7a 3b 20 7a 2b 2b 29 7b 0a  Name; *z; z++){.
5a00: 20 20 20 20 20 20 2a 7a 20 3d 20 73 71 6c 69 74        *z = sqlit
5a10: 65 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 2a  e3UpperToLower[*
5a20: 7a 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63  z];.    }.    rc
5a30: 20 3d 20 70 4d 6f 64 2d 3e 78 46 69 6e 64 46 75   = pMod->xFindFu
5a40: 6e 63 74 69 6f 6e 28 70 56 74 61 62 2c 20 6e 41  nction(pVtab, nA
5a50: 72 67 2c 20 7a 4c 6f 77 65 72 4e 61 6d 65 2c 20  rg, zLowerName, 
5a60: 26 78 46 75 6e 63 2c 20 26 70 41 72 67 29 3b 0a  &xFunc, &pArg);.
5a70: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
5a80: 28 7a 4c 6f 77 65 72 4e 61 6d 65 29 3b 0a 20 20  (zLowerName);.  
5a90: 7d 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b  }.  if( rc==0 ){
5aa0: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 44 65 66  .    return pDef
5ab0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65 61  ;.  }..  /* Crea
5ac0: 74 65 20 61 20 6e 65 77 20 65 70 68 65 6d 65 72  te a new ephemer
5ad0: 61 6c 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69  al function defi
5ae0: 6e 69 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6f  nition for the o
5af0: 76 65 72 6c 6f 61 64 65 64 0a 20 20 2a 2a 20 66  verloaded.  ** f
5b00: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 70 4e 65  unction */.  pNe
5b10: 77 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c  w = sqlite3DbMal
5b20: 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65  locZero(db, size
5b30: 6f 66 28 2a 70 4e 65 77 29 20 2b 20 73 74 72 6c  of(*pNew) + strl
5b40: 65 6e 28 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 20  en(pDef->zName) 
5b50: 29 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d 30  );.  if( pNew==0
5b60: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70   ){.    return p
5b70: 44 65 66 3b 0a 20 20 7d 0a 20 20 2a 70 4e 65 77  Def;.  }.  *pNew
5b80: 20 3d 20 2a 70 44 65 66 3b 0a 20 20 6d 65 6d 63   = *pDef;.  memc
5b90: 70 79 28 70 4e 65 77 2d 3e 7a 4e 61 6d 65 2c 20  py(pNew->zName, 
5ba0: 70 44 65 66 2d 3e 7a 4e 61 6d 65 2c 20 73 74 72  pDef->zName, str
5bb0: 6c 65 6e 28 70 44 65 66 2d 3e 7a 4e 61 6d 65 29  len(pDef->zName)
5bc0: 2b 31 29 3b 0a 20 20 70 4e 65 77 2d 3e 78 46 75  +1);.  pNew->xFu
5bd0: 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 4e  nc = xFunc;.  pN
5be0: 65 77 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20  ew->pUserData = 
5bf0: 70 41 72 67 3b 0a 20 20 70 4e 65 77 2d 3e 66 6c  pArg;.  pNew->fl
5c00: 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 46 55  ags |= SQLITE_FU
5c10: 4e 43 5f 45 50 48 45 4d 3b 0a 20 20 72 65 74 75  NC_EPHEM;.  retu
5c20: 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a 23 65 6e 64  rn pNew;.}..#end
5c30: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
5c40: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 20 2a  T_VIRTUALTABLE *
5c50: 2f 0a                                            /.