/ Hex Artifact Content
Login

Artifact c96f66005174cb2b43bf8cbb3c33257635ea2f683c9713aadd5209c27930586f:


0000: 2f 2a 0a 2a 2a 20 32 30 31 37 2d 30 35 2d 33 31  /*.** 2017-05-31
0010: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 6f  .**.** The autho
0020: 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 79  r disclaims copy
0030: 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 6f  right to this so
0040: 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 70  urce code.  In p
0050: 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 67  lace of.** a leg
0060: 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 20  al notice, here 
0070: 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a 2a  is a blessing:.*
0080: 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 20  *.**    May you 
0090: 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 20  do good and not 
00a0: 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 20  evil..**    May 
00b0: 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 65  you find forgive
00c0: 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 6c  ness for yoursel
00d0: 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f 74  f and forgive ot
00e0: 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 20  hers..**    May 
00f0: 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c 79  you share freely
0100: 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 6d  , never taking m
0110: 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 76  ore than you giv
0120: 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  e..**.**********
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 0a  ***************.
0170: 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20  **.** This file 
0180: 64 65 6d 6f 6e 73 74 72 61 74 65 73 20 61 6e 20  demonstrates an 
0190: 65 70 6f 6e 79 6d 6f 75 73 20 76 69 72 74 75 61  eponymous virtua
01a0: 6c 20 74 61 62 6c 65 20 74 68 61 74 20 72 65 74  l table that ret
01b0: 75 72 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  urns information
01c0: 0a 2a 2a 20 61 62 6f 75 74 20 61 6c 6c 20 70 72  .** about all pr
01d0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
01e0: 73 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61  s for the databa
01f0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a  se connection..*
0200: 2a 0a 2a 2a 20 55 73 61 67 65 20 65 78 61 6d 70  *.** Usage examp
0210: 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2e 6c  le:.**.**     .l
0220: 6f 61 64 20 2e 2f 73 74 6d 74 73 0a 2a 2a 20 20  oad ./stmts.**  
0230: 20 20 20 2e 6d 6f 64 65 20 6c 69 6e 65 0a 2a 2a     .mode line.**
0240: 20 20 20 20 20 2e 68 65 61 64 65 72 20 6f 6e 0a       .header on.
0250: 2a 2a 20 20 20 20 20 53 45 4c 45 43 54 20 2a 20  **     SELECT * 
0260: 46 52 4f 4d 20 73 74 6d 74 73 3b 0a 2a 2f 0a 23  FROM stmts;.*/.#
0270: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49  if !defined(SQLI
0280: 54 45 5f 43 4f 52 45 29 20 7c 7c 20 64 65 66 69  TE_CORE) || defi
0290: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ned(SQLITE_ENABL
02a0: 45 5f 53 54 4d 54 53 56 54 41 42 29 0a 23 69 66  E_STMTSVTAB).#if
02b0: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45   !defined(SQLITE
02c0: 49 4e 54 5f 48 29 0a 23 69 6e 63 6c 75 64 65 20  INT_H).#include 
02d0: 22 73 71 6c 69 74 65 33 65 78 74 2e 68 22 0a 23  "sqlite3ext.h".#
02e0: 65 6e 64 69 66 0a 53 51 4c 49 54 45 5f 45 58 54  endif.SQLITE_EXT
02f0: 45 4e 53 49 4f 4e 5f 49 4e 49 54 31 0a 23 69 6e  ENSION_INIT1.#in
0300: 63 6c 75 64 65 20 3c 61 73 73 65 72 74 2e 68 3e  clude <assert.h>
0310: 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 72 69 6e  .#include <strin
0320: 67 2e 68 3e 0a 0a 23 69 66 6e 64 65 66 20 53 51  g.h>..#ifndef SQ
0330: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41  LITE_OMIT_VIRTUA
0340: 4c 54 41 42 4c 45 0a 0a 2f 2a 0a 2a 2a 20 54 68  LTABLE../*.** Th
0350: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72  e following macr
0360: 6f 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 63  os are used to c
0370: 61 73 74 20 70 6f 69 6e 74 65 72 73 20 74 6f 20  ast pointers to 
0380: 69 6e 74 65 67 65 72 73 2e 0a 2a 2a 20 54 68 65  integers..** The
0390: 20 77 61 79 20 79 6f 75 20 64 6f 20 74 68 69 73   way you do this
03a0: 20 76 61 72 69 65 73 20 66 72 6f 6d 20 6f 6e 65   varies from one
03b0: 20 63 6f 6d 70 69 6c 65 72 0a 2a 2a 20 74 6f 20   compiler.** to 
03c0: 74 68 65 20 6e 65 78 74 2c 20 73 6f 20 77 65 20  the next, so we 
03d0: 68 61 76 65 20 64 65 76 65 6c 6f 70 65 64 20 74  have developed t
03e0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 74  he following set
03f0: 20 6f 66 20 23 69 66 20 73 74 61 74 65 6d 65 6e   of #if statemen
0400: 74 73 0a 2a 2a 20 74 6f 20 67 65 6e 65 72 61 74  ts.** to generat
0410: 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 6d 61  e appropriate ma
0420: 63 72 6f 73 20 66 6f 72 20 61 20 77 69 64 65 20  cros for a wide 
0430: 72 61 6e 67 65 20 6f 66 20 63 6f 6d 70 69 6c 65  range of compile
0440: 72 73 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e  rs..*/.#if defin
0450: 65 64 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50  ed(__PTRDIFF_TYP
0460: 45 5f 5f 29 20 20 2f 2a 20 54 68 69 73 20 63 61  E__)  /* This ca
0470: 73 65 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 66  se should work f
0480: 6f 72 20 47 43 43 20 2a 2f 0a 23 20 64 65 66 69  or GCC */.# defi
0490: 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f  ne SQLITE_PTR_TO
04a0: 5f 49 4e 54 36 34 28 58 29 20 20 28 28 73 71 6c  _INT64(X)  ((sql
04b0: 69 74 65 33 5f 69 6e 74 36 34 29 28 5f 5f 50 54  ite3_int64)(__PT
04c0: 52 44 49 46 46 5f 54 59 50 45 5f 5f 29 28 58 29  RDIFF_TYPE__)(X)
04d0: 29 0a 23 65 6c 69 66 20 21 64 65 66 69 6e 65 64  ).#elif !defined
04e0: 28 5f 5f 47 4e 55 43 5f 5f 29 20 20 20 20 20 20  (__GNUC__)      
04f0: 20 2f 2a 20 57 6f 72 6b 73 20 66 6f 72 20 63 6f   /* Works for co
0500: 6d 70 69 6c 65 72 73 20 6f 74 68 65 72 20 74 68  mpilers other th
0510: 61 6e 20 4c 4c 56 4d 20 2a 2f 0a 23 20 64 65 66  an LLVM */.# def
0520: 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54  ine SQLITE_PTR_T
0530: 4f 5f 49 4e 54 36 34 28 58 29 20 20 28 28 73 71  O_INT64(X)  ((sq
0540: 6c 69 74 65 33 5f 69 6e 74 36 34 29 28 28 28 63  lite3_int64)(((c
0550: 68 61 72 2a 29 58 29 2d 28 63 68 61 72 2a 29 30  har*)X)-(char*)0
0560: 29 29 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64  )).#elif defined
0570: 28 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 20  (HAVE_STDINT_H) 
0580: 20 20 2f 2a 20 55 73 65 20 74 68 69 73 20 63 61    /* Use this ca
0590: 73 65 20 69 66 20 77 65 20 68 61 76 65 20 41 4e  se if we have AN
05a0: 53 49 20 68 65 61 64 65 72 73 20 2a 2f 0a 23 20  SI headers */.# 
05b0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 54  define SQLITE_PT
05c0: 52 5f 54 4f 5f 49 4e 54 36 34 28 58 29 20 20 28  R_TO_INT64(X)  (
05d0: 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 28  (sqlite3_int64)(
05e0: 69 6e 74 70 74 72 5f 74 29 28 58 29 29 0a 23 65  intptr_t)(X)).#e
05f0: 6c 73 65 20 20 20 20 20 20 20 20 20 20 20 20 20  lse             
0600: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
0610: 47 65 6e 65 72 61 74 65 73 20 61 20 77 61 72 6e  Generates a warn
0620: 69 6e 67 20 2d 20 62 75 74 20 69 74 20 61 6c 77  ing - but it alw
0630: 61 79 73 20 77 6f 72 6b 73 20 2a 2f 0a 23 20 64  ays works */.# d
0640: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52  efine SQLITE_PTR
0650: 5f 54 4f 5f 49 4e 54 36 34 28 58 29 20 20 28 28  _TO_INT64(X)  ((
0660: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 28 58  sqlite3_int64)(X
0670: 29 29 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 20 73  )).#endif.../* s
0680: 74 6d 74 73 5f 76 74 61 62 20 69 73 20 61 20 73  tmts_vtab is a s
0690: 75 62 63 6c 61 73 73 20 6f 66 20 73 71 6c 69 74  ubclass of sqlit
06a0: 65 33 5f 76 74 61 62 20 77 68 69 63 68 20 77 69  e3_vtab which wi
06b0: 6c 6c 0a 2a 2a 20 73 65 72 76 65 20 61 73 20 74  ll.** serve as t
06c0: 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 72 65  he underlying re
06d0: 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20  presentation of 
06e0: 61 20 73 74 6d 74 73 20 76 69 72 74 75 61 6c 20  a stmts virtual 
06f0: 74 61 62 6c 65 0a 2a 2f 0a 74 79 70 65 64 65 66  table.*/.typedef
0700: 20 73 74 72 75 63 74 20 73 74 6d 74 73 5f 76 74   struct stmts_vt
0710: 61 62 20 73 74 6d 74 73 5f 76 74 61 62 3b 0a 73  ab stmts_vtab;.s
0720: 74 72 75 63 74 20 73 74 6d 74 73 5f 76 74 61 62  truct stmts_vtab
0730: 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61   {.  sqlite3_vta
0740: 62 20 62 61 73 65 3b 20 20 2f 2a 20 42 61 73 65  b base;  /* Base
0750: 20 63 6c 61 73 73 20 2d 20 6d 75 73 74 20 62 65   class - must be
0760: 20 66 69 72 73 74 20 2a 2f 0a 20 20 73 71 6c 69   first */.  sqli
0770: 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20  te3 *db;        
0780: 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e  /* Database conn
0790: 65 63 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20  ection for this 
07a0: 73 74 6d 74 73 20 76 74 61 62 20 2a 2f 0a 7d 3b  stmts vtab */.};
07b0: 0a 0a 2f 2a 20 73 74 6d 74 73 5f 63 75 72 73 6f  ../* stmts_curso
07c0: 72 20 69 73 20 61 20 73 75 62 63 6c 61 73 73 20  r is a subclass 
07d0: 6f 66 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f  of sqlite3_vtab_
07e0: 63 75 72 73 6f 72 20 77 68 69 63 68 20 77 69 6c  cursor which wil
07f0: 6c 0a 2a 2a 20 73 65 72 76 65 20 61 73 20 74 68  l.** serve as th
0800: 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 72 65 70  e underlying rep
0810: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61  resentation of a
0820: 20 63 75 72 73 6f 72 20 74 68 61 74 20 73 63 61   cursor that sca
0830: 6e 73 0a 2a 2a 20 6f 76 65 72 20 72 6f 77 73 20  ns.** over rows 
0840: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 0a 2a 2f  of the result.*/
0850: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
0860: 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 73 74 6d  stmts_cursor stm
0870: 74 73 5f 63 75 72 73 6f 72 3b 0a 73 74 72 75 63  ts_cursor;.struc
0880: 74 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 7b  t stmts_cursor {
0890: 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f  .  sqlite3_vtab_
08a0: 63 75 72 73 6f 72 20 62 61 73 65 3b 20 20 2f 2a  cursor base;  /*
08b0: 20 42 61 73 65 20 63 6c 61 73 73 20 2d 20 6d 75   Base class - mu
08c0: 73 74 20 62 65 20 66 69 72 73 74 20 2a 2f 0a 20  st be first */. 
08d0: 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20   sqlite3 *db;   
08e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
08f0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
0900: 6f 6e 20 66 6f 72 20 74 68 69 73 20 63 75 72 73  on for this curs
0910: 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  or */.  sqlite3_
0920: 73 74 6d 74 20 2a 70 53 74 6d 74 3b 20 20 20 20  stmt *pStmt;    
0930: 20 20 20 2f 2a 20 53 74 61 74 65 6d 65 6e 74 20     /* Statement 
0940: 63 75 72 73 6f 72 20 69 73 20 63 75 72 72 65 6e  cursor is curren
0950: 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 61 74 20  tly pointing at 
0960: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74  */.  sqlite3_int
0970: 36 34 20 69 52 6f 77 69 64 3b 20 20 20 20 20 20  64 iRowid;      
0980: 2f 2a 20 54 68 65 20 72 6f 77 69 64 20 2a 2f 0a  /* The rowid */.
0990: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 74  };../*.** The st
09a0: 6d 74 73 43 6f 6e 6e 65 63 74 28 29 20 6d 65 74  mtsConnect() met
09b0: 68 6f 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 74  hod is invoked t
09c0: 6f 20 63 72 65 61 74 65 20 61 20 6e 65 77 0a 2a  o create a new.*
09d0: 2a 20 73 74 6d 74 73 5f 76 74 61 62 20 74 68 61  * stmts_vtab tha
09e0: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
09f0: 67 65 6e 65 72 61 74 65 5f 73 74 6d 74 73 20 76  generate_stmts v
0a00: 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a  irtual table..**
0a10: 0a 2a 2a 20 54 68 69 6e 6b 20 6f 66 20 74 68 69  .** Think of thi
0a20: 73 20 72 6f 75 74 69 6e 65 20 61 73 20 74 68 65  s routine as the
0a30: 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 66 6f 72   constructor for
0a40: 20 73 74 6d 74 73 5f 76 74 61 62 20 6f 62 6a 65   stmts_vtab obje
0a50: 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 74  cts..**.** All t
0a60: 68 69 73 20 72 6f 75 74 69 6e 65 20 6e 65 65 64  his routine need
0a70: 73 20 74 6f 20 64 6f 20 69 73 3a 0a 2a 2a 0a 2a  s to do is:.**.*
0a80: 2a 20 20 20 20 28 31 29 20 41 6c 6c 6f 63 61 74  *    (1) Allocat
0a90: 65 20 74 68 65 20 73 74 6d 74 73 5f 76 74 61 62  e the stmts_vtab
0aa0: 20 6f 62 6a 65 63 74 20 61 6e 64 20 69 6e 69 74   object and init
0ab0: 69 61 6c 69 7a 65 20 61 6c 6c 20 66 69 65 6c 64  ialize all field
0ac0: 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 29 20  s..**.**    (2) 
0ad0: 54 65 6c 6c 20 53 51 4c 69 74 65 20 28 76 69 61  Tell SQLite (via
0ae0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 64 65 63   the sqlite3_dec
0af0: 6c 61 72 65 5f 76 74 61 62 28 29 20 69 6e 74 65  lare_vtab() inte
0b00: 72 66 61 63 65 29 20 77 68 61 74 20 74 68 65 0a  rface) what the.
0b10: 2a 2a 20 20 20 20 20 20 20 20 72 65 73 75 6c 74  **        result
0b20: 20 73 65 74 20 6f 66 20 71 75 65 72 69 65 73 20   set of queries 
0b30: 61 67 61 69 6e 73 74 20 67 65 6e 65 72 61 74 65  against generate
0b40: 5f 73 74 6d 74 73 20 77 69 6c 6c 20 6c 6f 6f 6b  _stmts will look
0b50: 20 6c 69 6b 65 2e 0a 2a 2f 0a 73 74 61 74 69 63   like..*/.static
0b60: 20 69 6e 74 20 73 74 6d 74 73 43 6f 6e 6e 65 63   int stmtsConnec
0b70: 74 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  t(.  sqlite3 *db
0b80: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 2c 0a  ,.  void *pAux,.
0b90: 20 20 69 6e 74 20 61 72 67 63 2c 20 63 6f 6e 73    int argc, cons
0ba0: 74 20 63 68 61 72 20 2a 63 6f 6e 73 74 2a 61 72  t char *const*ar
0bb0: 67 76 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 74  gv,.  sqlite3_vt
0bc0: 61 62 20 2a 2a 70 70 56 74 61 62 2c 0a 20 20 63  ab **ppVtab,.  c
0bd0: 68 61 72 20 2a 2a 70 7a 45 72 72 0a 29 7b 0a 20  har **pzErr.){. 
0be0: 20 73 74 6d 74 73 5f 76 74 61 62 20 2a 70 4e 65   stmts_vtab *pNe
0bf0: 77 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 2f 2a  w;.  int rc;../*
0c00: 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 73 20   Column numbers 
0c10: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54 4d 54 53  */.#define STMTS
0c20: 5f 43 4f 4c 55 4d 4e 5f 50 54 52 20 20 20 30 20  _COLUMN_PTR   0 
0c30: 20 20 20 2f 2a 20 4e 75 6d 65 72 69 63 20 76 61     /* Numeric va
0c40: 6c 75 65 20 6f 66 20 74 68 65 20 73 74 61 74 65  lue of the state
0c50: 6d 65 6e 74 20 70 6f 69 6e 74 65 72 20 2a 2f 0a  ment pointer */.
0c60: 23 64 65 66 69 6e 65 20 53 54 4d 54 53 5f 43 4f  #define STMTS_CO
0c70: 4c 55 4d 4e 5f 53 51 4c 20 20 20 31 20 20 20 20  LUMN_SQL   1    
0c80: 2f 2a 20 53 51 4c 20 66 6f 72 20 74 68 65 20 73  /* SQL for the s
0c90: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 23 64 65 66  tatement */.#def
0ca0: 69 6e 65 20 53 54 4d 54 53 5f 43 4f 4c 55 4d 4e  ine STMTS_COLUMN
0cb0: 5f 4e 43 4f 4c 20 20 32 20 20 20 20 2f 2a 20 4e  _NCOL  2    /* N
0cc0: 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20  umber of result 
0cd0: 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 23 64 65 66 69  columns */.#defi
0ce0: 6e 65 20 53 54 4d 54 53 5f 43 4f 4c 55 4d 4e 5f  ne STMTS_COLUMN_
0cf0: 52 4f 20 20 20 20 33 20 20 20 20 2f 2a 20 54 72  RO    3    /* Tr
0d00: 75 65 20 69 66 20 72 65 61 64 2d 6f 6e 6c 79 20  ue if read-only 
0d10: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54 4d 54 53  */.#define STMTS
0d20: 5f 43 4f 4c 55 4d 4e 5f 42 55 53 59 20 20 34 20  _COLUMN_BUSY  4 
0d30: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 75     /* True if cu
0d40: 72 72 65 6e 74 6c 79 20 62 75 73 79 20 2a 2f 0a  rrently busy */.
0d50: 23 64 65 66 69 6e 65 20 53 54 4d 54 53 5f 43 4f  #define STMTS_CO
0d60: 4c 55 4d 4e 5f 4e 53 43 41 4e 20 35 20 20 20 20  LUMN_NSCAN 5    
0d70: 2f 2a 20 53 51 4c 49 54 45 5f 53 54 4d 54 53 54  /* SQLITE_STMTST
0d80: 41 54 55 53 5f 46 55 4c 4c 53 43 41 4e 5f 53 54  ATUS_FULLSCAN_ST
0d90: 45 50 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54  EP */.#define ST
0da0: 4d 54 53 5f 43 4f 4c 55 4d 4e 5f 4e 53 4f 52 54  MTS_COLUMN_NSORT
0db0: 20 36 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f   6    /* SQLITE_
0dc0: 53 54 4d 54 53 54 41 54 55 53 5f 53 4f 52 54 20  STMTSTATUS_SORT 
0dd0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54 4d 54 53  */.#define STMTS
0de0: 5f 43 4f 4c 55 4d 4e 5f 4e 41 49 44 58 20 37 20  _COLUMN_NAIDX 7 
0df0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 53 54 4d     /* SQLITE_STM
0e00: 54 53 54 41 54 55 53 5f 41 55 54 4f 49 4e 44 45  TSTATUS_AUTOINDE
0e10: 58 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54 4d  X */.#define STM
0e20: 54 53 5f 43 4f 4c 55 4d 4e 5f 4e 53 54 45 50 20  TS_COLUMN_NSTEP 
0e30: 38 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 53  8    /* SQLITE_S
0e40: 54 4d 54 53 54 41 54 55 53 5f 56 4d 5f 53 54 45  TMTSTATUS_VM_STE
0e50: 50 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 54 4d  P */.#define STM
0e60: 54 53 5f 43 4f 4c 55 4d 4e 5f 4d 45 4d 20 20 20  TS_COLUMN_MEM   
0e70: 39 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 53  9    /* SQLITE_S
0e80: 54 4d 54 53 54 41 54 55 53 5f 4d 45 4d 55 53 45  TMTSTATUS_MEMUSE
0e90: 44 20 2a 2f 0a 0a 0a 20 20 72 63 20 3d 20 73 71  D */...  rc = sq
0ea0: 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74  lite3_declare_vt
0eb0: 61 62 28 64 62 2c 0a 20 20 20 20 20 22 43 52 45  ab(db,.     "CRE
0ec0: 41 54 45 20 54 41 42 4c 45 20 78 28 70 74 72 2c  ATE TABLE x(ptr,
0ed0: 73 71 6c 2c 6e 63 6f 6c 2c 72 6f 2c 62 75 73 79  sql,ncol,ro,busy
0ee0: 2c 6e 73 63 61 6e 2c 6e 73 6f 72 74 2c 6e 61 69  ,nscan,nsort,nai
0ef0: 64 78 2c 6e 73 74 65 70 2c 6d 65 6d 29 22 29 3b  dx,nstep,mem)");
0f00: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
0f10: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 4e 65 77  E_OK ){.    pNew
0f20: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f   = sqlite3_mallo
0f30: 63 28 20 73 69 7a 65 6f 66 28 2a 70 4e 65 77 29  c( sizeof(*pNew)
0f40: 20 29 3b 0a 20 20 20 20 2a 70 70 56 74 61 62 20   );.    *ppVtab 
0f50: 3d 20 28 73 71 6c 69 74 65 33 5f 76 74 61 62 2a  = (sqlite3_vtab*
0f60: 29 70 4e 65 77 3b 0a 20 20 20 20 69 66 28 20 70  )pNew;.    if( p
0f70: 4e 65 77 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  New==0 ) return 
0f80: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
0f90: 20 20 6d 65 6d 73 65 74 28 70 4e 65 77 2c 20 30    memset(pNew, 0
0fa0: 2c 20 73 69 7a 65 6f 66 28 2a 70 4e 65 77 29 29  , sizeof(*pNew))
0fb0: 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 64 62 20 3d  ;.    pNew->db =
0fc0: 20 64 62 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72   db;.  }.  retur
0fd0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  n rc;.}../*.** T
0fe0: 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 74 68  his method is th
0ff0: 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 6f 72  e destructor for
1000: 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 6f 62   stmts_cursor ob
1010: 6a 65 63 74 73 2e 0a 2a 2f 0a 73 74 61 74 69 63  jects..*/.static
1020: 20 69 6e 74 20 73 74 6d 74 73 44 69 73 63 6f 6e   int stmtsDiscon
1030: 6e 65 63 74 28 73 71 6c 69 74 65 33 5f 76 74 61  nect(sqlite3_vta
1040: 62 20 2a 70 56 74 61 62 29 7b 0a 20 20 73 71 6c  b *pVtab){.  sql
1050: 69 74 65 33 5f 66 72 65 65 28 70 56 74 61 62 29  ite3_free(pVtab)
1060: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
1070: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  E_OK;.}../*.** C
1080: 6f 6e 73 74 72 75 63 74 6f 72 20 66 6f 72 20 61  onstructor for a
1090: 20 6e 65 77 20 73 74 6d 74 73 5f 63 75 72 73 6f   new stmts_curso
10a0: 72 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 61  r object..*/.sta
10b0: 74 69 63 20 69 6e 74 20 73 74 6d 74 73 4f 70 65  tic int stmtsOpe
10c0: 6e 28 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a  n(sqlite3_vtab *
10d0: 70 2c 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f  p, sqlite3_vtab_
10e0: 63 75 72 73 6f 72 20 2a 2a 70 70 43 75 72 73 6f  cursor **ppCurso
10f0: 72 29 7b 0a 20 20 73 74 6d 74 73 5f 63 75 72 73  r){.  stmts_curs
1100: 6f 72 20 2a 70 43 75 72 3b 0a 20 20 70 43 75 72  or *pCur;.  pCur
1110: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f   = sqlite3_mallo
1120: 63 28 20 73 69 7a 65 6f 66 28 2a 70 43 75 72 29  c( sizeof(*pCur)
1130: 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 3d 3d   );.  if( pCur==
1140: 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54  0 ) return SQLIT
1150: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 6d 65 6d 73 65  E_NOMEM;.  memse
1160: 74 28 70 43 75 72 2c 20 30 2c 20 73 69 7a 65 6f  t(pCur, 0, sizeo
1170: 66 28 2a 70 43 75 72 29 29 3b 0a 20 20 70 43 75  f(*pCur));.  pCu
1180: 72 2d 3e 64 62 20 3d 20 28 28 73 74 6d 74 73 5f  r->db = ((stmts_
1190: 76 74 61 62 2a 29 70 29 2d 3e 64 62 3b 0a 20 20  vtab*)p)->db;.  
11a0: 2a 70 70 43 75 72 73 6f 72 20 3d 20 26 70 43 75  *ppCursor = &pCu
11b0: 72 2d 3e 62 61 73 65 3b 0a 20 20 72 65 74 75 72  r->base;.  retur
11c0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
11d0: 2f 2a 0a 2a 2a 20 44 65 73 74 72 75 63 74 6f 72  /*.** Destructor
11e0: 20 66 6f 72 20 61 20 73 74 6d 74 73 5f 63 75 72   for a stmts_cur
11f0: 73 6f 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  sor..*/.static i
1200: 6e 74 20 73 74 6d 74 73 43 6c 6f 73 65 28 73 71  nt stmtsClose(sq
1210: 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f  lite3_vtab_curso
1220: 72 20 2a 63 75 72 29 7b 0a 20 20 73 71 6c 69 74  r *cur){.  sqlit
1230: 65 33 5f 66 72 65 65 28 63 75 72 29 3b 0a 20 20  e3_free(cur);.  
1240: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
1250: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61  ;.}.../*.** Adva
1260: 6e 63 65 20 61 20 73 74 6d 74 73 5f 63 75 72 73  nce a stmts_curs
1270: 6f 72 20 74 6f 20 69 74 73 20 6e 65 78 74 20 72  or to its next r
1280: 6f 77 20 6f 66 20 6f 75 74 70 75 74 2e 0a 2a 2f  ow of output..*/
1290: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 74 6d 74  .static int stmt
12a0: 73 4e 65 78 74 28 73 71 6c 69 74 65 33 5f 76 74  sNext(sqlite3_vt
12b0: 61 62 5f 63 75 72 73 6f 72 20 2a 63 75 72 29 7b  ab_cursor *cur){
12c0: 0a 20 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20  .  stmts_cursor 
12d0: 2a 70 43 75 72 20 3d 20 28 73 74 6d 74 73 5f 63  *pCur = (stmts_c
12e0: 75 72 73 6f 72 2a 29 63 75 72 3b 0a 20 20 70 43  ursor*)cur;.  pC
12f0: 75 72 2d 3e 69 52 6f 77 69 64 2b 2b 3b 0a 20 20  ur->iRowid++;.  
1300: 70 43 75 72 2d 3e 70 53 74 6d 74 20 3d 20 73 71  pCur->pStmt = sq
1310: 6c 69 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74 28  lite3_next_stmt(
1320: 70 43 75 72 2d 3e 64 62 2c 20 70 43 75 72 2d 3e  pCur->db, pCur->
1330: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
1340: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
1350: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 76 61 6c 75  *.** Return valu
1360: 65 73 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 66 6f  es of columns fo
1370: 72 20 74 68 65 20 72 6f 77 20 61 74 20 77 68 69  r the row at whi
1380: 63 68 20 74 68 65 20 73 74 6d 74 73 5f 63 75 72  ch the stmts_cur
1390: 73 6f 72 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e  sor.** is curren
13a0: 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 0a 2a 2f  tly pointing..*/
13b0: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 74 6d 74  .static int stmt
13c0: 73 43 6f 6c 75 6d 6e 28 0a 20 20 73 71 6c 69 74  sColumn(.  sqlit
13d0: 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a  e3_vtab_cursor *
13e0: 63 75 72 2c 20 20 20 2f 2a 20 54 68 65 20 63 75  cur,   /* The cu
13f0: 72 73 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65  rsor */.  sqlite
1400: 33 5f 63 6f 6e 74 65 78 74 20 2a 63 74 78 2c 20  3_context *ctx, 
1410: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61        /* First a
1420: 72 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74  rgument to sqlit
1430: 65 33 5f 72 65 73 75 6c 74 5f 2e 2e 2e 28 29 20  e3_result_...() 
1440: 2a 2f 0a 20 20 69 6e 74 20 69 20 20 20 20 20 20  */.  int i      
1450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1460: 20 2f 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e   /* Which column
1470: 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 29 7b   to return */.){
1480: 0a 20 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20  .  stmts_cursor 
1490: 2a 70 43 75 72 20 3d 20 28 73 74 6d 74 73 5f 63  *pCur = (stmts_c
14a0: 75 72 73 6f 72 2a 29 63 75 72 3b 0a 20 20 73 77  ursor*)cur;.  sw
14b0: 69 74 63 68 28 20 69 20 29 7b 0a 20 20 20 20 63  itch( i ){.    c
14c0: 61 73 65 20 53 54 4d 54 53 5f 43 4f 4c 55 4d 4e  ase STMTS_COLUMN
14d0: 5f 50 54 52 3a 20 7b 0a 20 20 20 20 20 20 73 71  _PTR: {.      sq
14e0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
14f0: 36 34 28 63 74 78 2c 20 53 51 4c 49 54 45 5f 50  64(ctx, SQLITE_P
1500: 54 52 5f 54 4f 5f 49 4e 54 36 34 28 70 43 75 72  TR_TO_INT64(pCur
1510: 2d 3e 70 53 74 6d 74 29 29 3b 0a 20 20 20 20 20  ->pStmt));.     
1520: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
1530: 20 20 63 61 73 65 20 53 54 4d 54 53 5f 43 4f 4c    case STMTS_COL
1540: 55 4d 4e 5f 53 51 4c 3a 20 7b 0a 20 20 20 20 20  UMN_SQL: {.     
1550: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
1560: 74 65 78 74 28 63 74 78 2c 20 73 71 6c 69 74 65  text(ctx, sqlite
1570: 33 5f 73 71 6c 28 70 43 75 72 2d 3e 70 53 74 6d  3_sql(pCur->pStm
1580: 74 29 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 54  t), -1, SQLITE_T
1590: 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 20 20 20  RANSIENT);.     
15a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
15b0: 20 20 63 61 73 65 20 53 54 4d 54 53 5f 43 4f 4c    case STMTS_COL
15c0: 55 4d 4e 5f 4e 43 4f 4c 3a 20 7b 0a 20 20 20 20  UMN_NCOL: {.    
15d0: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74    sqlite3_result
15e0: 5f 69 6e 74 28 63 74 78 2c 20 73 71 6c 69 74 65  _int(ctx, sqlite
15f0: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70  3_column_count(p
1600: 43 75 72 2d 3e 70 53 74 6d 74 29 29 3b 0a 20 20  Cur->pStmt));.  
1610: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
1620: 0a 20 20 20 20 63 61 73 65 20 53 54 4d 54 53 5f  .    case STMTS_
1630: 43 4f 4c 55 4d 4e 5f 52 4f 3a 20 7b 0a 20 20 20  COLUMN_RO: {.   
1640: 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c     sqlite3_resul
1650: 74 5f 69 6e 74 28 63 74 78 2c 20 73 71 6c 69 74  t_int(ctx, sqlit
1660: 65 33 5f 73 74 6d 74 5f 72 65 61 64 6f 6e 6c 79  e3_stmt_readonly
1670: 28 70 43 75 72 2d 3e 70 53 74 6d 74 29 29 3b 0a  (pCur->pStmt));.
1680: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
1690: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 54 4d 54   }.    case STMT
16a0: 53 5f 43 4f 4c 55 4d 4e 5f 42 55 53 59 3a 20 7b  S_COLUMN_BUSY: {
16b0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72  .      sqlite3_r
16c0: 65 73 75 6c 74 5f 69 6e 74 28 63 74 78 2c 20 73  esult_int(ctx, s
16d0: 71 6c 69 74 65 33 5f 73 74 6d 74 5f 62 75 73 79  qlite3_stmt_busy
16e0: 28 70 43 75 72 2d 3e 70 53 74 6d 74 29 29 3b 0a  (pCur->pStmt));.
16f0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
1700: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 54 4d 54   }.    case STMT
1710: 53 5f 43 4f 4c 55 4d 4e 5f 4e 53 43 41 4e 3a 0a  S_COLUMN_NSCAN:.
1720: 20 20 20 20 63 61 73 65 20 53 54 4d 54 53 5f 43      case STMTS_C
1730: 4f 4c 55 4d 4e 5f 4e 53 4f 52 54 3a 0a 20 20 20  OLUMN_NSORT:.   
1740: 20 63 61 73 65 20 53 54 4d 54 53 5f 43 4f 4c 55   case STMTS_COLU
1750: 4d 4e 5f 4e 41 49 44 58 3a 0a 20 20 20 20 63 61  MN_NAIDX:.    ca
1760: 73 65 20 53 54 4d 54 53 5f 43 4f 4c 55 4d 4e 5f  se STMTS_COLUMN_
1770: 4e 53 54 45 50 3a 0a 20 20 20 20 63 61 73 65 20  NSTEP:.    case 
1780: 53 54 4d 54 53 5f 43 4f 4c 55 4d 4e 5f 4d 45 4d  STMTS_COLUMN_MEM
1790: 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  : {.      sqlite
17a0: 33 5f 72 65 73 75 6c 74 5f 69 6e 74 28 63 74 78  3_result_int(ctx
17b0: 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73  , sqlite3_stmt_s
17c0: 74 61 74 75 73 28 70 43 75 72 2d 3e 70 53 74 6d  tatus(pCur->pStm
17d0: 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  t,.             
17e0: 20 20 20 20 20 20 20 20 20 69 2d 53 54 4d 54 53           i-STMTS
17f0: 5f 43 4f 4c 55 4d 4e 5f 4e 53 43 41 4e 2b 53 51  _COLUMN_NSCAN+SQ
1800: 4c 49 54 45 5f 53 54 4d 54 53 54 41 54 55 53 5f  LITE_STMTSTATUS_
1810: 46 55 4c 4c 53 43 41 4e 5f 53 54 45 50 2c 20 30  FULLSCAN_STEP, 0
1820: 29 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  ));.      break;
1830: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
1840: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
1850: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
1860: 68 65 20 72 6f 77 69 64 20 66 6f 72 20 74 68 65  he rowid for the
1870: 20 63 75 72 72 65 6e 74 20 72 6f 77 2e 20 20 49   current row.  I
1880: 6e 20 74 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74  n this implement
1890: 61 74 69 6f 6e 2c 20 74 68 65 0a 2a 2a 20 72 6f  ation, the.** ro
18a0: 77 69 64 20 69 73 20 74 68 65 20 73 61 6d 65 20  wid is the same 
18b0: 61 73 20 74 68 65 20 6f 75 74 70 75 74 20 76 61  as the output va
18c0: 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  lue..*/.static i
18d0: 6e 74 20 73 74 6d 74 73 52 6f 77 69 64 28 73 71  nt stmtsRowid(sq
18e0: 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f  lite3_vtab_curso
18f0: 72 20 2a 63 75 72 2c 20 73 71 6c 69 74 65 5f 69  r *cur, sqlite_i
1900: 6e 74 36 34 20 2a 70 52 6f 77 69 64 29 7b 0a 20  nt64 *pRowid){. 
1910: 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 2a 70   stmts_cursor *p
1920: 43 75 72 20 3d 20 28 73 74 6d 74 73 5f 63 75 72  Cur = (stmts_cur
1930: 73 6f 72 2a 29 63 75 72 3b 0a 20 20 2a 70 52 6f  sor*)cur;.  *pRo
1940: 77 69 64 20 3d 20 70 43 75 72 2d 3e 69 52 6f 77  wid = pCur->iRow
1950: 69 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  id;.  return SQL
1960: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
1970: 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20   Return TRUE if 
1980: 74 68 65 20 63 75 72 73 6f 72 20 68 61 73 20 62  the cursor has b
1990: 65 65 6e 20 6d 6f 76 65 64 20 6f 66 66 20 6f 66  een moved off of
19a0: 20 74 68 65 20 6c 61 73 74 0a 2a 2a 20 72 6f 77   the last.** row
19b0: 20 6f 66 20 6f 75 74 70 75 74 2e 0a 2a 2f 0a 73   of output..*/.s
19c0: 74 61 74 69 63 20 69 6e 74 20 73 74 6d 74 73 45  tatic int stmtsE
19d0: 6f 66 28 73 71 6c 69 74 65 33 5f 76 74 61 62 5f  of(sqlite3_vtab_
19e0: 63 75 72 73 6f 72 20 2a 63 75 72 29 7b 0a 20 20  cursor *cur){.  
19f0: 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 2a 70 43  stmts_cursor *pC
1a00: 75 72 20 3d 20 28 73 74 6d 74 73 5f 63 75 72 73  ur = (stmts_curs
1a10: 6f 72 2a 29 63 75 72 3b 0a 20 20 72 65 74 75 72  or*)cur;.  retur
1a20: 6e 20 70 43 75 72 2d 3e 70 53 74 6d 74 3d 3d 30  n pCur->pStmt==0
1a30: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
1a40: 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64  method is called
1a50: 20 74 6f 20 22 72 65 77 69 6e 64 22 20 74 68 65   to "rewind" the
1a60: 20 73 74 6d 74 73 5f 63 75 72 73 6f 72 20 6f 62   stmts_cursor ob
1a70: 6a 65 63 74 20 62 61 63 6b 0a 2a 2a 20 74 6f 20  ject back.** to 
1a80: 74 68 65 20 66 69 72 73 74 20 72 6f 77 20 6f 66  the first row of
1a90: 20 6f 75 74 70 75 74 2e 20 20 54 68 69 73 20 6d   output.  This m
1aa0: 65 74 68 6f 64 20 69 73 20 61 6c 77 61 79 73 20  ethod is always 
1ab0: 63 61 6c 6c 65 64 20 61 74 20 6c 65 61 73 74 0a  called at least.
1ac0: 2a 2a 20 6f 6e 63 65 20 70 72 69 6f 72 20 74 6f  ** once prior to
1ad0: 20 61 6e 79 20 63 61 6c 6c 20 74 6f 20 73 74 6d   any call to stm
1ae0: 74 73 43 6f 6c 75 6d 6e 28 29 20 6f 72 20 73 74  tsColumn() or st
1af0: 6d 74 73 52 6f 77 69 64 28 29 20 6f 72 20 0a 2a  mtsRowid() or .*
1b00: 2a 20 73 74 6d 74 73 45 6f 66 28 29 2e 0a 2a 2f  * stmtsEof()..*/
1b10: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 74 6d 74  .static int stmt
1b20: 73 46 69 6c 74 65 72 28 0a 20 20 73 71 6c 69 74  sFilter(.  sqlit
1b30: 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a  e3_vtab_cursor *
1b40: 70 56 74 61 62 43 75 72 73 6f 72 2c 20 0a 20 20  pVtabCursor, .  
1b50: 69 6e 74 20 69 64 78 4e 75 6d 2c 20 63 6f 6e 73  int idxNum, cons
1b60: 74 20 63 68 61 72 20 2a 69 64 78 53 74 72 2c 0a  t char *idxStr,.
1b70: 20 20 69 6e 74 20 61 72 67 63 2c 20 73 71 6c 69    int argc, sqli
1b80: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 72 67 76  te3_value **argv
1b90: 0a 29 7b 0a 20 20 73 74 6d 74 73 5f 63 75 72 73  .){.  stmts_curs
1ba0: 6f 72 20 2a 70 43 75 72 20 3d 20 28 73 74 6d 74  or *pCur = (stmt
1bb0: 73 5f 63 75 72 73 6f 72 20 2a 29 70 56 74 61 62  s_cursor *)pVtab
1bc0: 43 75 72 73 6f 72 3b 0a 20 20 70 43 75 72 2d 3e  Cursor;.  pCur->
1bd0: 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 70 43 75  pStmt = 0;.  pCu
1be0: 72 2d 3e 69 52 6f 77 69 64 20 3d 20 30 3b 0a 20  r->iRowid = 0;. 
1bf0: 20 72 65 74 75 72 6e 20 73 74 6d 74 73 4e 65 78   return stmtsNex
1c00: 74 28 70 56 74 61 62 43 75 72 73 6f 72 29 3b 0a  t(pVtabCursor);.
1c10: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20  }../*.** SQLite 
1c20: 77 69 6c 6c 20 69 6e 76 6f 6b 65 20 74 68 69 73  will invoke this
1c30: 20 6d 65 74 68 6f 64 20 6f 6e 65 20 6f 72 20 6d   method one or m
1c40: 6f 72 65 20 74 69 6d 65 73 20 77 68 69 6c 65 20  ore times while 
1c50: 70 6c 61 6e 6e 69 6e 67 20 61 20 71 75 65 72 79  planning a query
1c60: 0a 2a 2a 20 74 68 61 74 20 75 73 65 73 20 74 68  .** that uses th
1c70: 65 20 67 65 6e 65 72 61 74 65 5f 73 74 6d 74 73  e generate_stmts
1c80: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20   virtual table. 
1c90: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6e 65   This routine ne
1ca0: 65 64 73 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a  eds to create.**
1cb0: 20 61 20 71 75 65 72 79 20 70 6c 61 6e 20 66 6f   a query plan fo
1cc0: 72 20 65 61 63 68 20 69 6e 76 6f 63 61 74 69 6f  r each invocatio
1cd0: 6e 20 61 6e 64 20 63 6f 6d 70 75 74 65 20 61 6e  n and compute an
1ce0: 20 65 73 74 69 6d 61 74 65 64 20 63 6f 73 74 20   estimated cost 
1cf0: 66 6f 72 20 74 68 61 74 0a 2a 2a 20 70 6c 61 6e  for that.** plan
1d00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
1d10: 73 74 6d 74 73 42 65 73 74 49 6e 64 65 78 28 0a  stmtsBestIndex(.
1d20: 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a    sqlite3_vtab *
1d30: 74 61 62 2c 0a 20 20 73 71 6c 69 74 65 33 5f 69  tab,.  sqlite3_i
1d40: 6e 64 65 78 5f 69 6e 66 6f 20 2a 70 49 64 78 49  ndex_info *pIdxI
1d50: 6e 66 6f 0a 29 7b 0a 20 20 70 49 64 78 49 6e 66  nfo.){.  pIdxInf
1d60: 6f 2d 3e 65 73 74 69 6d 61 74 65 64 43 6f 73 74  o->estimatedCost
1d70: 20 3d 20 28 64 6f 75 62 6c 65 29 35 30 30 3b 0a   = (double)500;.
1d80: 20 20 70 49 64 78 49 6e 66 6f 2d 3e 65 73 74 69    pIdxInfo->esti
1d90: 6d 61 74 65 64 52 6f 77 73 20 3d 20 35 30 30 3b  matedRows = 500;
1da0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
1db0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  _OK;.}../*.** Th
1dc0: 69 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72  is following str
1dd0: 75 63 74 75 72 65 20 64 65 66 69 6e 65 73 20 61  ucture defines a
1de0: 6c 6c 20 74 68 65 20 6d 65 74 68 6f 64 73 20 66  ll the methods f
1df0: 6f 72 20 74 68 65 20 0a 2a 2a 20 67 65 6e 65 72  or the .** gener
1e00: 61 74 65 5f 73 74 6d 74 73 20 76 69 72 74 75 61  ate_stmts virtua
1e10: 6c 20 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74  l table..*/.stat
1e20: 69 63 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c  ic sqlite3_modul
1e30: 65 20 73 74 6d 74 73 4d 6f 64 75 6c 65 20 3d 20  e stmtsModule = 
1e40: 7b 0a 20 20 30 2c 20 20 20 20 20 20 20 20 20 20  {.  0,          
1e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1e60: 2a 20 69 56 65 72 73 69 6f 6e 20 2a 2f 0a 20 20  * iVersion */.  
1e70: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
1e80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43             /* xC
1e90: 72 65 61 74 65 20 2a 2f 0a 20 20 73 74 6d 74 73  reate */.  stmts
1ea0: 43 6f 6e 6e 65 63 74 2c 20 20 20 20 20 20 20 20  Connect,        
1eb0: 20 20 20 20 20 2f 2a 20 78 43 6f 6e 6e 65 63 74       /* xConnect
1ec0: 20 2a 2f 0a 20 20 73 74 6d 74 73 42 65 73 74 49   */.  stmtsBestI
1ed0: 6e 64 65 78 2c 20 20 20 20 20 20 20 20 20 20 20  ndex,           
1ee0: 2f 2a 20 78 42 65 73 74 49 6e 64 65 78 20 2a 2f  /* xBestIndex */
1ef0: 0a 20 20 73 74 6d 74 73 44 69 73 63 6f 6e 6e 65  .  stmtsDisconne
1f00: 63 74 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ct,          /* 
1f10: 78 44 69 73 63 6f 6e 6e 65 63 74 20 2a 2f 0a 20  xDisconnect */. 
1f20: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
1f30: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
1f40: 44 65 73 74 72 6f 79 20 2a 2f 0a 20 20 73 74 6d  Destroy */.  stm
1f50: 74 73 4f 70 65 6e 2c 20 20 20 20 20 20 20 20 20  tsOpen,         
1f60: 20 20 20 20 20 20 20 2f 2a 20 78 4f 70 65 6e 20         /* xOpen 
1f70: 2d 20 6f 70 65 6e 20 61 20 63 75 72 73 6f 72 20  - open a cursor 
1f80: 2a 2f 0a 20 20 73 74 6d 74 73 43 6c 6f 73 65 2c  */.  stmtsClose,
1f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1fa0: 2a 20 78 43 6c 6f 73 65 20 2d 20 63 6c 6f 73 65  * xClose - close
1fb0: 20 61 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 73   a cursor */.  s
1fc0: 74 6d 74 73 46 69 6c 74 65 72 2c 20 20 20 20 20  tmtsFilter,     
1fd0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69 6c           /* xFil
1fe0: 74 65 72 20 2d 20 63 6f 6e 66 69 67 75 72 65 20  ter - configure 
1ff0: 73 63 61 6e 20 63 6f 6e 73 74 72 61 69 6e 74 73  scan constraints
2000: 20 2a 2f 0a 20 20 73 74 6d 74 73 4e 65 78 74 2c   */.  stmtsNext,
2010: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2020: 2f 2a 20 78 4e 65 78 74 20 2d 20 61 64 76 61 6e  /* xNext - advan
2030: 63 65 20 61 20 63 75 72 73 6f 72 20 2a 2f 0a 20  ce a cursor */. 
2040: 20 73 74 6d 74 73 45 6f 66 2c 20 20 20 20 20 20   stmtsEof,      
2050: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 45             /* xE
2060: 6f 66 20 2d 20 63 68 65 63 6b 20 66 6f 72 20 65  of - check for e
2070: 6e 64 20 6f 66 20 73 63 61 6e 20 2a 2f 0a 20 20  nd of scan */.  
2080: 73 74 6d 74 73 43 6f 6c 75 6d 6e 2c 20 20 20 20  stmtsColumn,    
2090: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6f            /* xCo
20a0: 6c 75 6d 6e 20 2d 20 72 65 61 64 20 64 61 74 61  lumn - read data
20b0: 20 2a 2f 0a 20 20 73 74 6d 74 73 52 6f 77 69 64   */.  stmtsRowid
20c0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
20d0: 2f 2a 20 78 52 6f 77 69 64 20 2d 20 72 65 61 64  /* xRowid - read
20e0: 20 64 61 74 61 20 2a 2f 0a 20 20 30 2c 20 20 20   data */.  0,   
20f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2100: 20 20 20 20 20 20 2f 2a 20 78 55 70 64 61 74 65        /* xUpdate
2110: 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20   */.  0,        
2120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2130: 20 2f 2a 20 78 42 65 67 69 6e 20 2a 2f 0a 20 20   /* xBegin */.  
2140: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
2150: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53             /* xS
2160: 79 6e 63 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20  ync */.  0,     
2170: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2180: 20 20 20 20 2f 2a 20 78 43 6f 6d 6d 69 74 20 2a      /* xCommit *
2190: 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20 20 20  /.  0,          
21a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
21b0: 2a 20 78 52 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20  * xRollback */. 
21c0: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
21d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
21e0: 46 69 6e 64 4d 65 74 68 6f 64 20 2a 2f 0a 20 20  FindMethod */.  
21f0: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
2200: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52             /* xR
2210: 65 6e 61 6d 65 20 2a 2f 0a 7d 3b 0a 0a 23 65 6e  ename */.};..#en
2220: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
2230: 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 20  IT_VIRTUALTABLE 
2240: 2a 2f 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 53  */..int sqlite3S
2250: 74 6d 74 73 56 74 61 62 49 6e 69 74 28 73 71 6c  tmtsVtabInit(sql
2260: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74  ite3 *db){.  int
2270: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
2280: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
2290: 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c  OMIT_VIRTUALTABL
22a0: 45 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  E.  rc = sqlite3
22b0: 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 64  _create_module(d
22c0: 62 2c 20 22 73 74 6d 74 73 22 2c 20 26 73 74 6d  b, "stmts", &stm
22d0: 74 73 4d 6f 64 75 6c 65 2c 20 30 29 3b 0a 23 65  tsModule, 0);.#e
22e0: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 72 63  ndif.  return rc
22f0: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c  ;.}..#ifndef SQL
2300: 49 54 45 5f 43 4f 52 45 0a 23 69 66 64 65 66 20  ITE_CORE.#ifdef 
2310: 5f 57 49 4e 33 32 0a 5f 5f 64 65 63 6c 73 70 65  _WIN32.__declspe
2320: 63 28 64 6c 6c 65 78 70 6f 72 74 29 0a 23 65 6e  c(dllexport).#en
2330: 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  dif.int sqlite3_
2340: 73 74 6d 74 73 5f 69 6e 69 74 28 0a 20 20 73 71  stmts_init(.  sq
2350: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 63 68  lite3 *db, .  ch
2360: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 2c 20 0a  ar **pzErrMsg, .
2370: 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f    const sqlite3_
2380: 61 70 69 5f 72 6f 75 74 69 6e 65 73 20 2a 70 41  api_routines *pA
2390: 70 69 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  pi.){.  int rc =
23a0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 53 51   SQLITE_OK;.  SQ
23b0: 4c 49 54 45 5f 45 58 54 45 4e 53 49 4f 4e 5f 49  LITE_EXTENSION_I
23c0: 4e 49 54 32 28 70 41 70 69 29 3b 0a 23 69 66 6e  NIT2(pApi);.#ifn
23d0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
23e0: 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69  VIRTUALTABLE.  i
23f0: 66 28 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 65  f( sqlite3_libve
2400: 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 29 3c 33  rsion_number()<3
2410: 30 30 38 30 31 32 20 29 7b 0a 20 20 20 20 2a 70  008012 ){.    *p
2420: 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65  zErrMsg = sqlite
2430: 33 5f 6d 70 72 69 6e 74 66 28 0a 20 20 20 20 20  3_mprintf(.     
2440: 20 20 20 22 67 65 6e 65 72 61 74 65 5f 73 74 6d     "generate_stm
2450: 74 73 28 29 20 72 65 71 75 69 72 65 73 20 53 51  ts() requires SQ
2460: 4c 69 74 65 20 33 2e 38 2e 31 32 20 6f 72 20 6c  Lite 3.8.12 or l
2470: 61 74 65 72 22 29 3b 0a 20 20 20 20 72 65 74 75  ater");.    retu
2480: 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b  rn SQLITE_ERROR;
2490: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69  .  }.  rc = sqli
24a0: 74 65 33 53 74 6d 74 73 56 74 61 62 49 6e 69 74  te3StmtsVtabInit
24b0: 28 64 62 29 3b 0a 23 65 6e 64 69 66 0a 20 20 72  (db);.#endif.  r
24c0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64  eturn rc;.}.#end
24d0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 52  if /* SQLITE_COR
24e0: 45 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 21  E */.#endif /* !
24f0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43  defined(SQLITE_C
2500: 4f 52 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 28  ORE) || defined(
2510: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54  SQLITE_ENABLE_ST
2520: 4d 54 53 56 54 41 42 29 20 2a 2f 0a              MTSVTAB) */.