/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact b7a684ff3508ab24437886f8bc873a16f494a7db:


0000: 2f 2a 0a 2a 2a 20 32 30 31 34 20 4d 61 79 20 33  /*.** 2014 May 3
0010: 31 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  1.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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 2a 2a 2a 2a 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e  *****.**.*/.#ifn
0180: 64 65 66 20 5f 46 54 53 35 49 4e 54 5f 48 0a 23  def _FTS5INT_H.#
0190: 64 65 66 69 6e 65 20 5f 46 54 53 35 49 4e 54 5f  define _FTS5INT_
01a0: 48 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c  H..#include "sql
01b0: 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75  iteInt.h".#inclu
01c0: 64 65 20 22 66 74 73 33 5f 74 6f 6b 65 6e 69 7a  de "fts3_tokeniz
01d0: 65 72 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 61  er.h".../*.** Ma
01e0: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
01f0: 70 72 65 66 69 78 20 69 6e 64 65 78 65 73 20 6f  prefix indexes o
0200: 6e 20 73 69 6e 67 6c 65 20 46 54 53 35 20 74 61  n single FTS5 ta
0210: 62 6c 65 2e 20 54 68 69 73 20 6d 75 73 74 20 62  ble. This must b
0220: 65 0a 2a 2a 20 6c 65 73 73 20 74 68 61 6e 20 33  e.** less than 3
0230: 32 2e 20 49 66 20 69 74 20 69 73 20 73 65 74 20  2. If it is set 
0240: 74 6f 20 61 6e 79 74 68 69 6e 67 20 6c 61 72 67  to anything larg
0250: 65 20 74 68 61 6e 20 74 68 61 74 2c 20 61 6e 20  e than that, an 
0260: 23 65 72 72 6f 72 0a 2a 2a 20 64 69 72 65 63 74  #error.** direct
0270: 69 76 65 20 69 6e 20 66 74 73 35 5f 69 6e 64 65  ive in fts5_inde
0280: 78 2e 63 20 77 69 6c 6c 20 63 61 75 73 65 20 74  x.c will cause t
0290: 68 65 20 62 75 69 6c 64 20 74 6f 20 66 61 69 6c  he build to fail
02a0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 46 54 53  ..*/.#define FTS
02b0: 35 5f 4d 41 58 5f 50 52 45 46 49 58 5f 49 4e 44  5_MAX_PREFIX_IND
02c0: 45 58 45 53 20 33 31 0a 0a 23 64 65 66 69 6e 65  EXES 31..#define
02d0: 20 46 54 53 35 5f 44 45 46 41 55 4c 54 5f 4e 45   FTS5_DEFAULT_NE
02e0: 41 52 44 49 53 54 20 31 30 0a 0a 2f 2a 2a 2a 2a  ARDIST 10../****
02f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0300: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0330: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65 72 66  ******.** Interf
0340: 61 63 65 20 74 6f 20 63 6f 64 65 20 69 6e 20 66  ace to code in f
0350: 74 73 35 5f 63 6f 6e 66 69 67 2e 63 2e 20 66 74  ts5_config.c. ft
0360: 73 35 5f 63 6f 6e 66 69 67 2e 63 20 63 6f 6e 74  s5_config.c cont
0370: 61 69 6e 73 20 63 6f 6e 74 61 69 6e 73 20 63 6f  ains contains co
0380: 64 65 0a 2a 2a 20 74 6f 20 70 61 72 73 65 20 74  de.** to parse t
0390: 68 65 20 61 72 67 75 6d 65 6e 74 73 20 70 61 73  he arguments pas
03a0: 73 65 64 20 74 6f 20 74 68 65 20 43 52 45 41 54  sed to the CREAT
03b0: 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20  E VIRTUAL TABLE 
03c0: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 0a 74  statement..*/..t
03d0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 74  ypedef struct Ft
03e0: 73 35 43 6f 6e 66 69 67 20 46 74 73 35 43 6f 6e  s5Config Fts5Con
03f0: 66 69 67 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69  fig;../*.** An i
0400: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66  nstance of the f
0410: 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75  ollowing structu
0420: 72 65 20 65 6e 63 6f 64 65 73 20 61 6c 6c 20 69  re encodes all i
0430: 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20  nformation that 
0440: 63 61 6e 0a 2a 2a 20 62 65 20 67 6c 65 61 6e 65  can.** be gleane
0450: 64 20 66 72 6f 6d 20 74 68 65 20 43 52 45 41 54  d from the CREAT
0460: 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20  E VIRTUAL TABLE 
0470: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74  statement..*/.st
0480: 72 75 63 74 20 46 74 73 35 43 6f 6e 66 69 67 20  ruct Fts5Config 
0490: 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b  {.  sqlite3 *db;
04a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
04b0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
04c0: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 68 61 72  handle */.  char
04d0: 20 2a 7a 44 62 3b 20 20 20 20 20 20 20 20 20 20   *zDb;          
04e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
04f0: 61 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 20  atabase holding 
0500: 46 54 53 20 69 6e 64 65 78 20 28 65 2e 67 2e 20  FTS index (e.g. 
0510: 22 6d 61 69 6e 22 29 20 2a 2f 0a 20 20 63 68 61  "main") */.  cha
0520: 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20  r *zName;       
0530: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
0540: 4e 61 6d 65 20 6f 66 20 46 54 53 20 69 6e 64 65  Name of FTS inde
0550: 78 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c 3b  x */.  int nCol;
0560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0570: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
0580: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20   of columns */. 
0590: 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 3b 20 20   char **azCol;  
05a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
05b0: 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73   /* Column names
05c0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 72 65 66 69   */.  int nPrefi
05d0: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  x;              
05e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
05f0: 6f 66 20 70 72 65 66 69 78 20 69 6e 64 65 78 65  of prefix indexe
0600: 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 50 72 65  s */.  int *aPre
0610: 66 69 78 3b 20 20 20 20 20 20 20 20 20 20 20 20  fix;            
0620: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 73 20         /* Sizes 
0630: 69 6e 20 62 79 74 65 73 20 6f 66 20 6e 50 72 65  in bytes of nPre
0640: 66 69 78 20 70 72 65 66 69 78 20 69 6e 64 65 78  fix prefix index
0650: 65 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  es */.  sqlite3_
0660: 74 6f 6b 65 6e 69 7a 65 72 20 2a 70 54 6f 6b 65  tokenizer *pToke
0670: 6e 69 7a 65 72 3b 20 20 2f 2a 20 54 6f 6b 65 6e  nizer;  /* Token
0680: 69 7a 65 72 20 69 6e 73 74 61 6e 63 65 20 66 6f  izer instance fo
0690: 72 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a  r this table */.
06a0: 7d 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 46  };..int sqlite3F
06b0: 74 73 35 43 6f 6e 66 69 67 50 61 72 73 65 28 73  ts5ConfigParse(s
06c0: 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 6f  qlite3*, int, co
06d0: 6e 73 74 20 63 68 61 72 2a 2a 2c 20 46 74 73 35  nst char**, Fts5
06e0: 43 6f 6e 66 69 67 2a 2a 2c 20 63 68 61 72 2a 2a  Config**, char**
06f0: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46  );.void sqlite3F
0700: 74 73 35 43 6f 6e 66 69 67 46 72 65 65 28 46 74  ts5ConfigFree(Ft
0710: 73 35 43 6f 6e 66 69 67 2a 29 3b 0a 0a 69 6e 74  s5Config*);..int
0720: 20 73 71 6c 69 74 65 33 46 74 73 35 43 6f 6e 66   sqlite3Fts5Conf
0730: 69 67 44 65 63 6c 61 72 65 56 74 61 62 28 46 74  igDeclareVtab(Ft
0740: 73 35 43 6f 6e 66 69 67 20 2a 70 43 6f 6e 66 69  s5Config *pConfi
0750: 67 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33  g);..int sqlite3
0760: 46 74 73 35 54 6f 6b 65 6e 69 7a 65 28 0a 20 20  Fts5Tokenize(.  
0770: 46 74 73 35 43 6f 6e 66 69 67 20 2a 70 43 6f 6e  Fts5Config *pCon
0780: 66 69 67 2c 20 20 20 20 20 20 20 20 20 20 20 20  fig,            
0790: 2f 2a 20 46 54 53 35 20 43 6f 6e 66 69 67 75 72  /* FTS5 Configur
07a0: 61 74 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f 0a  ation object */.
07b0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 54    const char *pT
07c0: 65 78 74 2c 20 69 6e 74 20 6e 54 65 78 74 2c 20  ext, int nText, 
07d0: 20 20 2f 2a 20 54 65 78 74 20 74 6f 20 74 6f 6b    /* Text to tok
07e0: 65 6e 69 7a 65 20 2a 2f 0a 20 20 76 6f 69 64 20  enize */.  void 
07f0: 2a 70 43 74 78 2c 20 20 20 20 20 20 20 20 20 20  *pCtx,          
0800: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
0810: 6e 74 65 78 74 20 70 61 73 73 65 64 20 74 6f 20  ntext passed to 
0820: 78 54 6f 6b 65 6e 28 29 20 2a 2f 0a 20 20 69 6e  xToken() */.  in
0830: 74 20 28 2a 78 54 6f 6b 65 6e 29 28 76 6f 69 64  t (*xToken)(void
0840: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20  *, const char*, 
0850: 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69  int, int, int, i
0860: 6e 74 29 20 20 20 20 2f 2a 20 43 61 6c 6c 62 61  nt)    /* Callba
0870: 63 6b 20 2a 2f 0a 29 3b 0a 0a 76 6f 69 64 20 73  ck */.);..void s
0880: 71 6c 69 74 65 33 46 74 73 35 44 65 71 75 6f 74  qlite3Fts5Dequot
0890: 65 28 63 68 61 72 20 2a 7a 29 3b 0a 0a 2f 2a 0a  e(char *z);../*.
08a0: 2a 2a 20 45 6e 64 20 6f 66 20 69 6e 74 65 72 66  ** End of interf
08b0: 61 63 65 20 74 6f 20 63 6f 64 65 20 69 6e 20 66  ace to code in f
08c0: 74 73 35 5f 63 6f 6e 66 69 67 2e 63 2e 0a 2a 2a  ts5_config.c..**
08d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
08e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
08f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0900: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0910: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a  ********/../****
0920: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0930: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0940: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0950: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0960: 2a 2a 2a 2a 2a 2a 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a  ******.*/../*.**
0970: 20 42 75 66 66 65 72 20 6f 62 6a 65 63 74 20 66   Buffer object f
0980: 6f 72 20 74 68 65 20 69 6e 63 72 65 6d 65 6e 74  or the increment
0990: 61 6c 20 62 75 69 6c 64 69 6e 67 20 6f 66 20 73  al building of s
09a0: 74 72 69 6e 67 20 64 61 74 61 2e 0a 2a 2f 0a 74  tring data..*/.t
09b0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 74  ypedef struct Ft
09c0: 73 35 42 75 66 66 65 72 20 46 74 73 35 42 75 66  s5Buffer Fts5Buf
09d0: 66 65 72 3b 0a 73 74 72 75 63 74 20 46 74 73 35  fer;.struct Fts5
09e0: 42 75 66 66 65 72 20 7b 0a 20 20 75 38 20 2a 70  Buffer {.  u8 *p
09f0: 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 69 6e 74  ;.  int n;.  int
0a00: 20 6e 53 70 61 63 65 3b 0a 7d 3b 0a 0a 69 6e 74   nSpace;.};..int
0a10: 20 73 71 6c 69 74 65 33 46 74 73 35 42 75 66 66   sqlite3Fts5Buff
0a20: 65 72 47 72 6f 77 28 69 6e 74 2a 2c 20 46 74 73  erGrow(int*, Fts
0a30: 35 42 75 66 66 65 72 2a 2c 20 69 6e 74 29 3b 0a  5Buffer*, int);.
0a40: 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73 35  void sqlite3Fts5
0a50: 42 75 66 66 65 72 41 70 70 65 6e 64 56 61 72 69  BufferAppendVari
0a60: 6e 74 28 69 6e 74 2a 2c 20 46 74 73 35 42 75 66  nt(int*, Fts5Buf
0a70: 66 65 72 2a 2c 20 69 36 34 29 3b 0a 76 6f 69 64  fer*, i64);.void
0a80: 20 73 71 6c 69 74 65 33 46 74 73 35 42 75 66 66   sqlite3Fts5Buff
0a90: 65 72 41 70 70 65 6e 64 42 6c 6f 62 28 69 6e 74  erAppendBlob(int
0aa0: 2a 2c 20 46 74 73 35 42 75 66 66 65 72 2a 2c 20  *, Fts5Buffer*, 
0ab0: 69 6e 74 2c 20 63 6f 6e 73 74 20 75 38 2a 29 3b  int, const u8*);
0ac0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73  .void sqlite3Fts
0ad0: 35 42 75 66 66 65 72 41 70 70 65 6e 64 53 74 72  5BufferAppendStr
0ae0: 69 6e 67 28 69 6e 74 20 2a 2c 20 46 74 73 35 42  ing(int *, Fts5B
0af0: 75 66 66 65 72 2a 2c 20 63 6f 6e 73 74 20 63 68  uffer*, const ch
0b00: 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74  ar*);.void sqlit
0b10: 65 33 46 74 73 35 42 75 66 66 65 72 46 72 65 65  e3Fts5BufferFree
0b20: 28 46 74 73 35 42 75 66 66 65 72 2a 29 3b 0a 76  (Fts5Buffer*);.v
0b30: 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73 35 42  oid sqlite3Fts5B
0b40: 75 66 66 65 72 5a 65 72 6f 28 46 74 73 35 42 75  ufferZero(Fts5Bu
0b50: 66 66 65 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  ffer*);.void sql
0b60: 69 74 65 33 46 74 73 35 42 75 66 66 65 72 53 65  ite3Fts5BufferSe
0b70: 74 28 69 6e 74 2a 2c 20 46 74 73 35 42 75 66 66  t(int*, Fts5Buff
0b80: 65 72 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20  er*, int, const 
0b90: 75 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74  u8*);.void sqlit
0ba0: 65 33 46 74 73 35 42 75 66 66 65 72 41 70 70 65  e3Fts5BufferAppe
0bb0: 6e 64 50 72 69 6e 74 66 28 69 6e 74 20 2a 2c 20  ndPrintf(int *, 
0bc0: 46 74 73 35 42 75 66 66 65 72 2a 2c 20 63 68 61  Fts5Buffer*, cha
0bd0: 72 20 2a 7a 46 6d 74 2c 20 2e 2e 2e 29 3b 0a 0a  r *zFmt, ...);..
0be0: 23 64 65 66 69 6e 65 20 66 74 73 35 42 75 66 66  #define fts5Buff
0bf0: 65 72 5a 65 72 6f 28 78 29 20 20 20 20 20 20 20  erZero(x)       
0c00: 20 20 20 20 20 20 73 71 6c 69 74 65 33 46 74 73        sqlite3Fts
0c10: 35 42 75 66 66 65 72 5a 65 72 6f 28 78 29 0a 23  5BufferZero(x).#
0c20: 64 65 66 69 6e 65 20 66 74 73 35 42 75 66 66 65  define fts5Buffe
0c30: 72 47 72 6f 77 28 61 2c 62 2c 63 29 20 20 20 20  rGrow(a,b,c)    
0c40: 20 20 20 20 20 73 71 6c 69 74 65 33 46 74 73 35       sqlite3Fts5
0c50: 42 75 66 66 65 72 47 72 6f 77 28 61 2c 62 2c 63  BufferGrow(a,b,c
0c60: 29 0a 23 64 65 66 69 6e 65 20 66 74 73 35 42 75  ).#define fts5Bu
0c70: 66 66 65 72 41 70 70 65 6e 64 56 61 72 69 6e 74  fferAppendVarint
0c80: 28 61 2c 62 2c 63 29 20 73 71 6c 69 74 65 33 46  (a,b,c) sqlite3F
0c90: 74 73 35 42 75 66 66 65 72 41 70 70 65 6e 64 56  ts5BufferAppendV
0ca0: 61 72 69 6e 74 28 61 2c 62 2c 63 29 0a 23 64 65  arint(a,b,c).#de
0cb0: 66 69 6e 65 20 66 74 73 35 42 75 66 66 65 72 46  fine fts5BufferF
0cc0: 72 65 65 28 61 29 20 20 20 20 20 20 20 20 20 20  ree(a)          
0cd0: 20 20 20 73 71 6c 69 74 65 33 46 74 73 35 42 75     sqlite3Fts5Bu
0ce0: 66 66 65 72 46 72 65 65 28 61 29 0a 23 64 65 66  fferFree(a).#def
0cf0: 69 6e 65 20 66 74 73 35 42 75 66 66 65 72 41 70  ine fts5BufferAp
0d00: 70 65 6e 64 42 6c 6f 62 28 61 2c 62 2c 63 2c 64  pendBlob(a,b,c,d
0d10: 29 20 73 71 6c 69 74 65 33 46 74 73 35 42 75 66  ) sqlite3Fts5Buf
0d20: 66 65 72 41 70 70 65 6e 64 42 6c 6f 62 28 61 2c  ferAppendBlob(a,
0d30: 62 2c 63 2c 64 29 0a 23 64 65 66 69 6e 65 20 66  b,c,d).#define f
0d40: 74 73 35 42 75 66 66 65 72 53 65 74 28 61 2c 62  ts5BufferSet(a,b
0d50: 2c 63 2c 64 29 20 20 20 20 20 20 20 20 73 71 6c  ,c,d)        sql
0d60: 69 74 65 33 46 74 73 35 42 75 66 66 65 72 53 65  ite3Fts5BufferSe
0d70: 74 28 61 2c 62 2c 63 2c 64 29 0a 0a 2f 2a 0a 2a  t(a,b,c,d)../*.*
0d80: 2a 20 45 6e 64 20 6f 66 20 69 6e 74 65 72 66 61  * End of interfa
0d90: 63 65 20 74 6f 20 63 6f 64 65 20 69 6e 20 66 74  ce to code in ft
0da0: 73 35 5f 62 75 66 66 65 72 2e 63 2e 0a 2a 2a 2a  s5_buffer.c..***
0db0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0dc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0dd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0de0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0df0: 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a  *******/../*****
0e00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0e10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0e20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0e30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0e40: 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65 72 66 61  *****.** Interfa
0e50: 63 65 20 74 6f 20 63 6f 64 65 20 69 6e 20 66 74  ce to code in ft
0e60: 73 35 5f 69 6e 64 65 78 2e 63 2e 20 66 74 73 35  s5_index.c. fts5
0e70: 5f 69 6e 64 65 78 2e 63 20 63 6f 6e 74 61 69 6e  _index.c contain
0e80: 73 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 0a  s contains code.
0e90: 2a 2a 20 74 6f 20 61 63 63 65 73 73 20 74 68 65  ** to access the
0ea0: 20 64 61 74 61 20 73 74 6f 72 65 64 20 69 6e 20   data stored in 
0eb0: 74 68 65 20 25 5f 64 61 74 61 20 74 61 62 6c 65  the %_data table
0ec0: 2e 0a 2a 2f 0a 0a 74 79 70 65 64 65 66 20 73 74  ..*/..typedef st
0ed0: 72 75 63 74 20 46 74 73 35 49 6e 64 65 78 20 46  ruct Fts5Index F
0ee0: 74 73 35 49 6e 64 65 78 3b 0a 74 79 70 65 64 65  ts5Index;.typede
0ef0: 66 20 73 74 72 75 63 74 20 46 74 73 35 49 6e 64  f struct Fts5Ind
0f00: 65 78 49 74 65 72 20 46 74 73 35 49 6e 64 65 78  exIter Fts5Index
0f10: 49 74 65 72 3b 0a 0a 2f 2a 0a 2a 2a 20 56 61 6c  Iter;../*.** Val
0f20: 75 65 73 20 75 73 65 64 20 61 73 20 70 61 72 74  ues used as part
0f30: 20 6f 66 20 74 68 65 20 66 6c 61 67 73 20 61 72   of the flags ar
0f40: 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f  gument passed to
0f50: 20 49 6e 64 65 78 51 75 65 72 79 28 29 2e 0a 2a   IndexQuery()..*
0f60: 2f 0a 23 64 65 66 69 6e 65 20 46 54 53 35 49 4e  /.#define FTS5IN
0f70: 44 45 58 5f 51 55 45 52 59 5f 50 52 45 46 49 58  DEX_QUERY_PREFIX
0f80: 20 30 78 30 30 30 31 20 20 20 20 20 20 20 2f 2a   0x0001       /*
0f90: 20 50 72 65 66 69 78 20 71 75 65 72 79 20 2a 2f   Prefix query */
0fa0: 0a 23 64 65 66 69 6e 65 20 46 54 53 35 49 4e 44  .#define FTS5IND
0fb0: 45 58 5f 51 55 45 52 59 5f 41 53 43 20 20 20 20  EX_QUERY_ASC    
0fc0: 30 78 30 30 30 32 20 20 20 20 20 20 20 2f 2a 20  0x0002       /* 
0fd0: 44 6f 63 73 20 69 6e 20 61 73 63 65 6e 64 69 6e  Docs in ascendin
0fe0: 67 20 72 6f 77 69 64 20 6f 72 64 65 72 20 2a 2f  g rowid order */
0ff0: 0a 23 64 65 66 69 6e 65 20 46 54 53 35 49 4e 44  .#define FTS5IND
1000: 45 58 5f 51 55 45 52 59 5f 4d 41 54 43 48 20 20  EX_QUERY_MATCH  
1010: 30 78 30 30 30 34 20 20 20 20 20 20 20 2f 2a 20  0x0004       /* 
1020: 55 73 65 20 74 68 65 20 69 4d 61 74 63 68 20 61  Use the iMatch a
1030: 72 67 20 74 6f 20 4e 65 78 74 28 29 20 2a 2f 0a  rg to Next() */.
1040: 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 2f 64 65  ./*.** Create/de
1050: 73 74 72 6f 79 20 61 6e 20 46 74 73 35 49 6e 64  stroy an Fts5Ind
1060: 65 78 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 69 6e  ex object..*/.in
1070: 74 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64  t sqlite3Fts5Ind
1080: 65 78 4f 70 65 6e 28 46 74 73 35 43 6f 6e 66 69  exOpen(Fts5Confi
1090: 67 20 2a 70 43 6f 6e 66 69 67 2c 20 69 6e 74 20  g *pConfig, int 
10a0: 62 43 72 65 61 74 65 2c 20 46 74 73 35 49 6e 64  bCreate, Fts5Ind
10b0: 65 78 2a 2a 2c 20 63 68 61 72 2a 2a 29 3b 0a 69  ex**, char**);.i
10c0: 6e 74 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e  nt sqlite3Fts5In
10d0: 64 65 78 43 6c 6f 73 65 28 46 74 73 35 49 6e 64  dexClose(Fts5Ind
10e0: 65 78 20 2a 70 2c 20 69 6e 74 20 62 44 65 73 74  ex *p, int bDest
10f0: 72 6f 79 29 3b 0a 0a 2f 2a 0a 2a 2a 20 66 6f 72  roy);../*.** for
1100: 28 0a 2a 2a 20 20 20 70 49 74 65 72 20 3d 20 73  (.**   pIter = s
1110: 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65 78 51  qlite3Fts5IndexQ
1120: 75 65 72 79 28 70 2c 20 22 74 6f 6b 65 6e 22 2c  uery(p, "token",
1130: 20 35 2c 20 30 29 3b 0a 2a 2a 20 20 20 30 3d 3d   5, 0);.**   0==
1140: 73 71 6c 69 74 65 33 46 74 73 35 49 74 65 72 45  sqlite3Fts5IterE
1150: 6f 66 28 70 49 74 65 72 29 3b 0a 2a 2a 20 20 20  of(pIter);.**   
1160: 73 71 6c 69 74 65 33 46 74 73 35 49 74 65 72 4e  sqlite3Fts5IterN
1170: 65 78 74 28 70 49 74 65 72 29 0a 2a 2a 20 29 7b  ext(pIter).** ){
1180: 0a 2a 2a 20 20 20 69 36 34 20 69 44 6f 63 69 64  .**   i64 iDocid
1190: 20 3d 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e   = sqlite3Fts5In
11a0: 64 65 78 44 6f 63 69 64 28 70 49 74 65 72 29 3b  dexDocid(pIter);
11b0: 0a 2a 2a 20 7d 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  .** }.*/../*.** 
11c0: 4f 70 65 6e 20 61 20 6e 65 77 20 69 74 65 72 61  Open a new itera
11d0: 74 6f 72 20 74 6f 20 69 74 65 72 61 74 65 20 74  tor to iterate t
11e0: 68 6f 75 67 68 20 61 6c 6c 20 64 6f 63 69 64 73  hough all docids
11f0: 20 74 68 61 74 20 6d 61 74 63 68 20 74 68 65 20   that match the 
1200: 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 74 6f  .** specified to
1210: 6b 65 6e 20 6f 72 20 74 6f 6b 65 6e 20 70 72 65  ken or token pre
1220: 66 69 78 2e 0a 2a 2f 0a 46 74 73 35 49 6e 64 65  fix..*/.Fts5Inde
1230: 78 49 74 65 72 20 2a 73 71 6c 69 74 65 33 46 74  xIter *sqlite3Ft
1240: 73 35 49 6e 64 65 78 51 75 65 72 79 28 0a 20 20  s5IndexQuery(.  
1250: 46 74 73 35 49 6e 64 65 78 20 2a 70 2c 20 20 20  Fts5Index *p,   
1260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1270: 2f 2a 20 46 54 53 20 69 6e 64 65 78 20 74 6f 20  /* FTS index to 
1280: 71 75 65 72 79 20 2a 2f 0a 20 20 63 6f 6e 73 74  query */.  const
1290: 20 63 68 61 72 20 2a 70 54 6f 6b 65 6e 2c 20 69   char *pToken, i
12a0: 6e 74 20 6e 54 6f 6b 65 6e 2c 20 2f 2a 20 54 6f  nt nToken, /* To
12b0: 6b 65 6e 20 28 6f 72 20 70 72 65 66 69 78 29 20  ken (or prefix) 
12c0: 74 6f 20 71 75 65 72 79 20 66 6f 72 20 2a 2f 0a  to query for */.
12d0: 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 20    int flags     
12e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
12f0: 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 46 54 53    /* Mask of FTS
1300: 35 49 4e 44 45 58 5f 51 55 45 52 59 5f 58 20 66  5INDEX_QUERY_X f
1310: 6c 61 67 73 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a  lags */.);../*.*
1320: 2a 20 44 6f 63 69 64 20 6c 69 73 74 20 69 74 65  * Docid list ite
1330: 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 20  ration..*/.int  
1340: 73 71 6c 69 74 65 33 46 74 73 35 49 74 65 72 45  sqlite3Fts5IterE
1350: 6f 66 28 46 74 73 35 49 6e 64 65 78 49 74 65 72  of(Fts5IndexIter
1360: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  *);.void sqlite3
1370: 46 74 73 35 49 74 65 72 4e 65 78 74 28 46 74 73  Fts5IterNext(Fts
1380: 35 49 6e 64 65 78 49 74 65 72 2a 2c 20 69 36 34  5IndexIter*, i64
1390: 20 69 4d 61 74 63 68 29 3b 0a 69 36 34 20 20 73   iMatch);.i64  s
13a0: 71 6c 69 74 65 33 46 74 73 35 49 74 65 72 52 6f  qlite3Fts5IterRo
13b0: 77 69 64 28 46 74 73 35 49 6e 64 65 78 49 74 65  wid(Fts5IndexIte
13c0: 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 62 74 61  r*);../*.** Obta
13d0: 69 6e 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 20  in the position 
13e0: 6c 69 73 74 20 74 68 61 74 20 63 6f 72 72 65 73  list that corres
13f0: 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 63 75 72  ponds to the cur
1400: 72 65 6e 74 20 70 6f 73 69 74 69 6f 6e 2e 0a 2a  rent position..*
1410: 2f 0a 63 6f 6e 73 74 20 75 38 20 2a 73 71 6c 69  /.const u8 *sqli
1420: 74 65 33 46 74 73 35 49 74 65 72 50 6f 73 6c 69  te3Fts5IterPosli
1430: 73 74 28 46 74 73 35 49 6e 64 65 78 49 74 65 72  st(Fts5IndexIter
1440: 2a 2c 20 69 6e 74 20 2a 70 6e 29 3b 0a 0a 2f 2a  *, int *pn);../*
1450: 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 69 74 65  .** Close an ite
1460: 72 61 74 6f 72 20 6f 70 65 6e 65 64 20 62 79 20  rator opened by 
1470: 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65 78  sqlite3Fts5Index
1480: 51 75 65 72 79 28 29 2e 0a 2a 2f 0a 76 6f 69 64  Query()..*/.void
1490: 20 73 71 6c 69 74 65 33 46 74 73 35 49 74 65 72   sqlite3Fts5Iter
14a0: 43 6c 6f 73 65 28 46 74 73 35 49 6e 64 65 78 49  Close(Fts5IndexI
14b0: 74 65 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e  ter*);../*.** In
14c0: 73 65 72 74 20 6f 72 20 72 65 6d 6f 76 65 20 64  sert or remove d
14d0: 61 74 61 20 74 6f 20 6f 72 20 66 72 6f 6d 20 74  ata to or from t
14e0: 68 65 20 69 6e 64 65 78 2e 20 45 61 63 68 20 74  he index. Each t
14f0: 69 6d 65 20 61 20 64 6f 63 75 6d 65 6e 74 20 69  ime a document i
1500: 73 20 0a 2a 2a 20 61 64 64 65 64 20 74 6f 20 6f  s .** added to o
1510: 72 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74  r removed from t
1520: 68 65 20 69 6e 64 65 78 2c 20 74 68 69 73 20 66  he index, this f
1530: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
1540: 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a 2a 2a  d one or more.**
1550: 20 74 69 6d 65 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f   times..**.** Fo
1560: 72 20 61 6e 20 69 6e 73 65 72 74 2c 20 69 74 20  r an insert, it 
1570: 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 6f  must be called o
1580: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 74 6f 6b  nce for each tok
1590: 65 6e 20 69 6e 20 74 68 65 20 6e 65 77 20 64 6f  en in the new do
15a0: 63 75 6d 65 6e 74 2e 0a 2a 2a 20 49 66 20 74 68  cument..** If th
15b0: 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 61  e operation is a
15c0: 20 64 65 6c 65 74 65 2c 20 69 74 20 6d 75 73 74   delete, it must
15d0: 20 62 65 20 63 61 6c 6c 65 64 20 28 61 74 20 6c   be called (at l
15e0: 65 61 73 74 29 20 6f 6e 63 65 20 66 6f 72 20 65  east) once for e
15f0: 61 63 68 0a 2a 2a 20 75 6e 69 71 75 65 20 74 6f  ach.** unique to
1600: 6b 65 6e 20 69 6e 20 74 68 65 20 64 6f 63 75 6d  ken in the docum
1610: 65 6e 74 20 77 69 74 68 20 61 6e 20 69 43 6f 6c  ent with an iCol
1620: 20 76 61 6c 75 65 20 6c 65 73 73 20 74 68 61 6e   value less than
1630: 20 7a 65 72 6f 2e 20 54 68 65 20 69 50 6f 73 0a   zero. The iPos.
1640: 2a 2a 20 61 72 67 75 6d 65 6e 74 20 69 73 20 69  ** argument is i
1650: 67 6e 6f 72 65 64 20 66 6f 72 20 61 20 64 65 6c  gnored for a del
1660: 65 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ete..*/.void sql
1670: 69 74 65 33 46 74 73 35 49 6e 64 65 78 57 72 69  ite3Fts5IndexWri
1680: 74 65 28 0a 20 20 46 74 73 35 49 6e 64 65 78 20  te(.  Fts5Index 
1690: 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  *p,             
16a0: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 74        /* Index t
16b0: 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a 20 20  o write to */.  
16c0: 69 6e 74 20 69 43 6f 6c 2c 20 20 20 20 20 20 20  int iCol,       
16d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
16e0: 2f 2a 20 43 6f 6c 75 6d 6e 20 74 6f 6b 65 6e 20  /* Column token 
16f0: 61 70 70 65 61 72 73 20 69 6e 20 28 2d 76 65 20  appears in (-ve 
1700: 2d 3e 20 64 65 6c 65 74 65 29 20 2a 2f 0a 20 20  -> delete) */.  
1710: 69 6e 74 20 69 50 6f 73 2c 20 20 20 20 20 20 20  int iPos,       
1720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1730: 2f 2a 20 50 6f 73 69 74 69 6f 6e 20 6f 66 20 74  /* Position of t
1740: 6f 6b 65 6e 20 77 69 74 68 69 6e 20 63 6f 6c 75  oken within colu
1750: 6d 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  mn */.  const ch
1760: 61 72 20 2a 70 54 6f 6b 65 6e 2c 20 69 6e 74 20  ar *pToken, int 
1770: 6e 54 6f 6b 65 6e 20 20 2f 2a 20 54 6f 6b 65 6e  nToken  /* Token
1780: 20 74 6f 20 61 64 64 20 6f 72 20 72 65 6d 6f 76   to add or remov
1790: 65 20 74 6f 20 6f 72 20 66 72 6f 6d 20 69 6e 64  e to or from ind
17a0: 65 78 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20  ex */.);../*.** 
17b0: 49 6e 64 69 63 61 74 65 20 74 68 61 74 20 73 75  Indicate that su
17c0: 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74  bsequent calls t
17d0: 6f 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64  o sqlite3Fts5Ind
17e0: 65 78 57 72 69 74 65 28 29 20 70 65 72 74 61 69  exWrite() pertai
17f0: 6e 20 74 6f 0a 2a 2a 20 64 6f 63 75 6d 65 6e 74  n to.** document
1800: 20 69 44 6f 63 69 64 2e 0a 2a 2f 0a 76 6f 69 64   iDocid..*/.void
1810: 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65   sqlite3Fts5Inde
1820: 78 42 65 67 69 6e 57 72 69 74 65 28 0a 20 20 46  xBeginWrite(.  F
1830: 74 73 35 49 6e 64 65 78 20 2a 70 2c 20 20 20 20  ts5Index *p,    
1840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1850: 2a 20 49 6e 64 65 78 20 74 6f 20 77 72 69 74 65  * Index to write
1860: 20 74 6f 20 2a 2f 0a 20 20 69 36 34 20 69 44 6f   to */.  i64 iDo
1870: 63 69 64 20 20 20 20 20 20 20 20 20 20 20 20 20  cid             
1880: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 63 69           /* Doci
1890: 64 20 74 6f 20 61 64 64 20 6f 72 20 72 65 6d 6f  d to add or remo
18a0: 76 65 20 64 61 74 61 20 66 72 6f 6d 20 2a 2f 0a  ve data from */.
18b0: 29 3b 0a 0a 2f 2a 0a 2a 2a 20 46 6c 75 73 68 20  );../*.** Flush 
18c0: 61 6e 79 20 64 61 74 61 20 73 74 6f 72 65 64 20  any data stored 
18d0: 69 6e 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79  in the in-memory
18e0: 20 68 61 73 68 20 74 61 62 6c 65 73 20 74 6f 20   hash tables to 
18f0: 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a  the database..**
1900: 0a 2a 2a 20 54 68 69 73 20 69 73 20 63 61 6c 6c  .** This is call
1910: 65 64 20 77 68 65 6e 65 76 65 72 20 28 61 29 20  ed whenever (a) 
1920: 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 63  the main transac
1930: 74 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65  tion is committe
1940: 64 20 6f 72 20 28 62 29 20 61 20 0a 2a 2a 20 6e  d or (b) a .** n
1950: 65 77 20 73 75 62 2d 74 72 61 6e 73 61 63 74 69  ew sub-transacti
1960: 6f 6e 20 69 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f  on is opened..*/
1970: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73  .void sqlite3Fts
1980: 35 49 6e 64 65 78 46 6c 75 73 68 28 46 74 73 35  5IndexFlush(Fts5
1990: 49 6e 64 65 78 20 2a 70 29 3b 0a 0a 69 6e 74 20  Index *p);..int 
19a0: 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65 78  sqlite3Fts5Index
19b0: 53 79 6e 63 28 46 74 73 35 49 6e 64 65 78 20 2a  Sync(Fts5Index *
19c0: 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61  p);../*.** Disca
19d0: 72 64 20 61 6e 79 20 64 61 74 61 20 73 74 6f 72  rd any data stor
19e0: 65 64 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65 6d  ed in the in-mem
19f0: 6f 72 79 20 68 61 73 68 20 74 61 62 6c 65 73 2e  ory hash tables.
1a00: 20 44 6f 20 6e 6f 74 20 77 72 69 74 65 20 69 74   Do not write it
1a10: 0a 2a 2a 20 74 6f 20 74 68 65 20 64 61 74 61 62  .** to the datab
1a20: 61 73 65 2e 20 41 64 64 69 74 69 6f 6e 61 6c 6c  ase. Additionall
1a30: 79 2c 20 61 73 73 75 6d 65 20 74 68 61 74 20 74  y, assume that t
1a40: 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74  he contents of t
1a50: 68 65 20 25 5f 64 61 74 61 0a 2a 2a 20 74 61 62  he %_data.** tab
1a60: 6c 65 20 6d 61 79 20 68 61 76 65 20 63 68 61 6e  le may have chan
1a70: 67 65 64 20 6f 6e 20 64 69 73 6b 2e 20 53 6f 20  ged on disk. So 
1a80: 61 6e 79 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61  any in-memory ca
1a90: 63 68 65 73 20 6f 66 20 25 5f 64 61 74 61 20 0a  ches of %_data .
1aa0: 2a 2a 20 72 65 63 6f 72 64 73 20 6d 75 73 74 20  ** records must 
1ab0: 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 2e 0a  be invalidated..
1ac0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 63 61  **.** This is ca
1ad0: 6c 6c 65 64 20 28 61 29 20 77 68 65 6e 65 76 65  lled (a) wheneve
1ae0: 72 20 61 20 6d 61 69 6e 20 6f 72 20 73 75 62 2d  r a main or sub-
1af0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72  transaction is r
1b00: 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 0a 2a 2a 20  olled back, .** 
1b10: 61 6e 64 20 28 62 29 20 77 68 65 6e 65 76 65 72  and (b) whenever
1b20: 20 74 68 65 20 72 65 61 64 20 74 72 61 6e 73 61   the read transa
1b30: 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e  ction is closed.
1b40: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 46  .*/.int sqlite3F
1b50: 74 73 35 49 6e 64 65 78 52 6f 6c 6c 62 61 63 6b  ts5IndexRollback
1b60: 28 46 74 73 35 49 6e 64 65 78 20 2a 70 29 3b 0a  (Fts5Index *p);.
1b70: 0a 2f 2a 0a 2a 2a 20 52 65 74 72 69 65 76 65 20  ./*.** Retrieve 
1b80: 61 6e 64 20 63 6c 65 61 72 20 74 68 65 20 63 75  and clear the cu
1b90: 72 72 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65  rrent error code
1ba0: 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e 0a  , respectively..
1bb0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 74  */.int sqlite3Ft
1bc0: 73 35 49 6e 64 65 78 45 72 72 63 6f 64 65 28 46  s5IndexErrcode(F
1bd0: 74 73 35 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64  ts5Index*);.void
1be0: 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65   sqlite3Fts5Inde
1bf0: 78 52 65 73 65 74 28 46 74 73 35 49 6e 64 65 78  xReset(Fts5Index
1c00: 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 28  *);../*.** Get (
1c10: 62 53 65 74 3d 3d 30 29 20 6f 72 20 73 65 74 20  bSet==0) or set 
1c20: 28 62 53 65 74 21 3d 30 29 20 74 68 65 20 22 61  (bSet!=0) the "a
1c30: 76 65 72 61 67 65 73 22 20 72 65 63 6f 72 64 2e  verages" record.
1c40: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
1c50: 46 74 73 35 49 6e 64 65 78 41 76 65 72 61 67 65  Fts5IndexAverage
1c60: 73 28 46 74 73 35 49 6e 64 65 78 20 2a 70 2c 20  s(Fts5Index *p, 
1c70: 69 6e 74 20 62 53 65 74 2c 20 69 6e 74 20 6e 41  int bSet, int nA
1c80: 76 67 2c 20 69 6e 74 20 2a 61 41 76 67 29 3b 0a  vg, int *aAvg);.
1c90: 0a 2f 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 73  ./*.** Functions
1ca0: 20 63 61 6c 6c 65 64 20 62 79 20 74 68 65 20 73   called by the s
1cb0: 74 6f 72 61 67 65 20 6d 6f 64 75 6c 65 20 61 73  torage module as
1cc0: 20 70 61 72 74 20 6f 66 20 69 6e 74 65 67 72 69   part of integri
1cd0: 74 79 2d 63 68 65 63 6b 2e 0a 2a 2f 0a 75 36 34  ty-check..*/.u64
1ce0: 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65   sqlite3Fts5Inde
1cf0: 78 43 6b 73 75 6d 28 46 74 73 35 43 6f 6e 66 69  xCksum(Fts5Confi
1d00: 67 2a 2c 69 36 34 2c 69 6e 74 2c 69 6e 74 2c 63  g*,i64,int,int,c
1d10: 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b  onst char*,int);
1d20: 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 35  .int sqlite3Fts5
1d30: 49 6e 64 65 78 49 6e 74 65 67 72 69 74 79 43 68  IndexIntegrityCh
1d40: 65 63 6b 28 46 74 73 35 49 6e 64 65 78 2a 2c 20  eck(Fts5Index*, 
1d50: 75 36 34 20 63 6b 73 75 6d 29 3b 0a 0a 2f 2a 20  u64 cksum);../* 
1d60: 43 61 6c 6c 65 64 20 64 75 72 69 6e 67 20 73 74  Called during st
1d70: 61 72 74 75 70 20 74 6f 20 72 65 67 69 73 74 65  artup to registe
1d80: 72 20 61 20 55 44 46 20 77 69 74 68 20 53 51 4c  r a UDF with SQL
1d90: 69 74 65 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ite */.int sqlit
1da0: 65 33 46 74 73 35 49 6e 64 65 78 49 6e 69 74 28  e3Fts5IndexInit(
1db0: 73 71 6c 69 74 65 33 2a 29 3b 0a 0a 76 6f 69 64  sqlite3*);..void
1dc0: 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e 64 65   sqlite3Fts5Inde
1dd0: 78 50 67 73 7a 28 46 74 73 35 49 6e 64 65 78 20  xPgsz(Fts5Index 
1de0: 2a 70 2c 20 69 6e 74 20 70 67 73 7a 29 3b 0a 0a  *p, int pgsz);..
1df0: 2f 2a 0a 2a 2a 20 45 6e 64 20 6f 66 20 69 6e 74  /*.** End of int
1e00: 65 72 66 61 63 65 20 74 6f 20 63 6f 64 65 20 69  erface to code i
1e10: 6e 20 66 74 73 35 5f 69 6e 64 65 78 2e 63 2e 0a  n fts5_index.c..
1e20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a  **********/../**
1e70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1e90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1ea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1eb0: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65  ********.** Inte
1ec0: 72 66 61 63 65 20 74 6f 20 63 6f 64 65 20 69 6e  rface to code in
1ed0: 20 66 74 73 35 5f 73 74 6f 72 61 67 65 2e 63 2e   fts5_storage.c.
1ee0: 20 66 74 73 35 5f 73 74 6f 72 61 67 65 2e 63 20   fts5_storage.c 
1ef0: 63 6f 6e 74 61 69 6e 73 20 63 6f 6e 74 61 69 6e  contains contain
1f00: 73 20 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 61 63  s .** code to ac
1f10: 63 65 73 73 20 74 68 65 20 64 61 74 61 20 73 74  cess the data st
1f20: 6f 72 65 64 20 69 6e 20 74 68 65 20 25 5f 63 6f  ored in the %_co
1f30: 6e 74 65 6e 74 20 61 6e 64 20 25 5f 64 6f 63 73  ntent and %_docs
1f40: 69 7a 65 20 74 61 62 6c 65 73 2e 0a 2a 2f 0a 0a  ize tables..*/..
1f50: 23 64 65 66 69 6e 65 20 46 54 53 35 5f 53 54 4d  #define FTS5_STM
1f60: 54 5f 53 43 41 4e 5f 41 53 43 20 20 30 20 20 20  T_SCAN_ASC  0   
1f70: 20 20 2f 2a 20 53 45 4c 45 43 54 20 72 6f 77 69    /* SELECT rowi
1f80: 64 2c 20 2a 20 46 52 4f 4d 20 2e 2e 2e 20 4f 52  d, * FROM ... OR
1f90: 44 45 52 20 42 59 20 31 20 41 53 43 20 2a 2f 0a  DER BY 1 ASC */.
1fa0: 23 64 65 66 69 6e 65 20 46 54 53 35 5f 53 54 4d  #define FTS5_STM
1fb0: 54 5f 53 43 41 4e 5f 44 45 53 43 20 31 20 20 20  T_SCAN_DESC 1   
1fc0: 20 20 2f 2a 20 53 45 4c 45 43 54 20 72 6f 77 69    /* SELECT rowi
1fd0: 64 2c 20 2a 20 46 52 4f 4d 20 2e 2e 2e 20 4f 52  d, * FROM ... OR
1fe0: 44 45 52 20 42 59 20 31 20 44 45 53 43 20 2a 2f  DER BY 1 DESC */
1ff0: 0a 23 64 65 66 69 6e 65 20 46 54 53 35 5f 53 54  .#define FTS5_ST
2000: 4d 54 5f 4c 4f 4f 4b 55 50 20 20 20 20 32 20 20  MT_LOOKUP    2  
2010: 20 20 20 2f 2a 20 53 45 4c 45 43 54 20 72 6f 77     /* SELECT row
2020: 69 64 2c 20 2a 20 46 52 4f 4d 20 2e 2e 2e 20 57  id, * FROM ... W
2030: 48 45 52 45 20 72 6f 77 69 64 3d 3f 20 2a 2f 0a  HERE rowid=? */.
2040: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
2050: 46 74 73 35 53 74 6f 72 61 67 65 20 46 74 73 35  Fts5Storage Fts5
2060: 53 74 6f 72 61 67 65 3b 0a 0a 69 6e 74 20 73 71  Storage;..int sq
2070: 6c 69 74 65 33 46 74 73 35 53 74 6f 72 61 67 65  lite3Fts5Storage
2080: 4f 70 65 6e 28 46 74 73 35 43 6f 6e 66 69 67 2a  Open(Fts5Config*
2090: 2c 20 46 74 73 35 49 6e 64 65 78 2a 2c 20 69 6e  , Fts5Index*, in
20a0: 74 2c 20 46 74 73 35 53 74 6f 72 61 67 65 2a 2a  t, Fts5Storage**
20b0: 2c 20 63 68 61 72 2a 2a 29 3b 0a 69 6e 74 20 73  , char**);.int s
20c0: 71 6c 69 74 65 33 46 74 73 35 53 74 6f 72 61 67  qlite3Fts5Storag
20d0: 65 43 6c 6f 73 65 28 46 74 73 35 53 74 6f 72 61  eClose(Fts5Stora
20e0: 67 65 20 2a 70 2c 20 69 6e 74 20 62 44 65 73 74  ge *p, int bDest
20f0: 72 6f 79 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74  roy);..int sqlit
2100: 65 33 46 74 73 35 44 72 6f 70 54 61 62 6c 65 28  e3Fts5DropTable(
2110: 46 74 73 35 43 6f 6e 66 69 67 2a 2c 20 63 6f 6e  Fts5Config*, con
2120: 73 74 20 63 68 61 72 20 2a 7a 50 6f 73 74 29 3b  st char *zPost);
2130: 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 35  .int sqlite3Fts5
2140: 43 72 65 61 74 65 54 61 62 6c 65 28 46 74 73 35  CreateTable(Fts5
2150: 43 6f 6e 66 69 67 2a 2c 20 63 6f 6e 73 74 20 63  Config*, const c
2160: 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72  har*, const char
2170: 2a 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 29  *, char **pzErr)
2180: 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 74  ;..int sqlite3Ft
2190: 73 35 53 74 6f 72 61 67 65 44 65 6c 65 74 65 28  s5StorageDelete(
21a0: 46 74 73 35 53 74 6f 72 61 67 65 20 2a 70 2c 20  Fts5Storage *p, 
21b0: 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  i64);.int sqlite
21c0: 33 46 74 73 35 53 74 6f 72 61 67 65 49 6e 73 65  3Fts5StorageInse
21d0: 72 74 28 46 74 73 35 53 74 6f 72 61 67 65 20 2a  rt(Fts5Storage *
21e0: 70 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  p, sqlite3_value
21f0: 20 2a 2a 61 70 56 61 6c 2c 20 69 6e 74 2c 20 69   **apVal, int, i
2200: 36 34 2a 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74  64*);..int sqlit
2210: 65 33 46 74 73 35 53 74 6f 72 61 67 65 49 6e 74  e3Fts5StorageInt
2220: 65 67 72 69 74 79 28 46 74 73 35 53 74 6f 72 61  egrity(Fts5Stora
2230: 67 65 20 2a 70 29 3b 0a 0a 69 6e 74 20 73 71 6c  ge *p);..int sql
2240: 69 74 65 33 46 74 73 35 53 74 6f 72 61 67 65 53  ite3Fts5StorageS
2250: 74 6d 74 28 46 74 73 35 53 74 6f 72 61 67 65 20  tmt(Fts5Storage 
2260: 2a 70 2c 20 69 6e 74 20 65 53 74 6d 74 2c 20 73  *p, int eStmt, s
2270: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 29 3b  qlite3_stmt **);
2280: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73  .void sqlite3Fts
2290: 35 53 74 6f 72 61 67 65 53 74 6d 74 52 65 6c 65  5StorageStmtRele
22a0: 61 73 65 28 46 74 73 35 53 74 6f 72 61 67 65 20  ase(Fts5Storage 
22b0: 2a 70 2c 20 69 6e 74 20 65 53 74 6d 74 2c 20 73  *p, int eStmt, s
22c0: 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 3b 0a 0a  qlite3_stmt*);..
22d0: 0a 2f 2a 0a 2a 2a 20 45 6e 64 20 6f 66 20 69 6e  ./*.** End of in
22e0: 74 65 72 66 61 63 65 20 74 6f 20 63 6f 64 65 20  terface to code 
22f0: 69 6e 20 66 74 73 35 5f 73 74 6f 72 61 67 65 2e  in fts5_storage.
2300: 63 2e 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  c..*************
2310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
2350: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
2360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20  ************.** 
23a0: 49 6e 74 65 72 66 61 63 65 20 74 6f 20 63 6f 64  Interface to cod
23b0: 65 20 69 6e 20 66 74 73 35 5f 65 78 70 72 2e 63  e in fts5_expr.c
23c0: 2e 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74  . .*/.typedef st
23d0: 72 75 63 74 20 46 74 73 35 45 78 70 72 20 46 74  ruct Fts5Expr Ft
23e0: 73 35 45 78 70 72 3b 0a 74 79 70 65 64 65 66 20  s5Expr;.typedef 
23f0: 73 74 72 75 63 74 20 46 74 73 35 45 78 70 72 4e  struct Fts5ExprN
2400: 6f 64 65 20 46 74 73 35 45 78 70 72 4e 6f 64 65  ode Fts5ExprNode
2410: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ;.typedef struct
2420: 20 46 74 73 35 50 61 72 73 65 20 46 74 73 35 50   Fts5Parse Fts5P
2430: 61 72 73 65 3b 0a 74 79 70 65 64 65 66 20 73 74  arse;.typedef st
2440: 72 75 63 74 20 46 74 73 35 54 6f 6b 65 6e 20 46  ruct Fts5Token F
2450: 74 73 35 54 6f 6b 65 6e 3b 0a 74 79 70 65 64 65  ts5Token;.typede
2460: 66 20 73 74 72 75 63 74 20 46 74 73 35 45 78 70  f struct Fts5Exp
2470: 72 50 68 72 61 73 65 20 46 74 73 35 45 78 70 72  rPhrase Fts5Expr
2480: 50 68 72 61 73 65 3b 0a 74 79 70 65 64 65 66 20  Phrase;.typedef 
2490: 73 74 72 75 63 74 20 46 74 73 35 45 78 70 72 4e  struct Fts5ExprN
24a0: 65 61 72 73 65 74 20 46 74 73 35 45 78 70 72 4e  earset Fts5ExprN
24b0: 65 61 72 73 65 74 3b 0a 0a 73 74 72 75 63 74 20  earset;..struct 
24c0: 46 74 73 35 54 6f 6b 65 6e 20 7b 0a 20 20 63 6f  Fts5Token {.  co
24d0: 6e 73 74 20 63 68 61 72 20 2a 70 3b 20 20 20 20  nst char *p;    
24e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
24f0: 20 54 6f 6b 65 6e 20 74 65 78 74 20 28 6e 6f 74   Token text (not
2500: 20 4e 55 4c 4c 20 74 65 72 6d 69 6e 61 74 65 64   NULL terminated
2510: 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 3b 20 20 20  ) */.  int n;   
2520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2530: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f         /* Size o
2540: 66 20 62 75 66 66 65 72 20 70 20 69 6e 20 62 79  f buffer p in by
2550: 74 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 50 61  tes */.};../* Pa
2560: 72 73 65 20 61 20 4d 41 54 43 48 20 65 78 70 72  rse a MATCH expr
2570: 65 73 73 69 6f 6e 2e 20 2a 2f 0a 69 6e 74 20 73  ession. */.int s
2580: 71 6c 69 74 65 33 46 74 73 35 45 78 70 72 4e 65  qlite3Fts5ExprNe
2590: 77 28 0a 20 20 46 74 73 35 43 6f 6e 66 69 67 20  w(.  Fts5Config 
25a0: 2a 70 43 6f 6e 66 69 67 2c 20 0a 20 20 63 6f 6e  *pConfig, .  con
25b0: 73 74 20 63 68 61 72 20 2a 7a 45 78 70 72 2c 0a  st char *zExpr,.
25c0: 20 20 46 74 73 35 45 78 70 72 20 2a 2a 70 70 4e    Fts5Expr **ppN
25d0: 65 77 2c 20 0a 20 20 63 68 61 72 20 2a 2a 70 7a  ew, .  char **pz
25e0: 45 72 72 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 66 6f  Err.);../*.** fo
25f0: 72 28 72 63 20 3d 20 73 71 6c 69 74 65 33 46 74  r(rc = sqlite3Ft
2600: 73 35 45 78 70 72 46 69 72 73 74 28 70 45 78 70  s5ExprFirst(pExp
2610: 72 2c 20 70 49 64 78 2c 20 62 41 73 63 29 3b 0a  r, pIdx, bAsc);.
2620: 2a 2a 20 20 20 20 20 72 63 3d 3d 53 51 4c 49 54  **     rc==SQLIT
2630: 45 5f 4f 4b 20 26 26 20 30 3d 3d 73 71 6c 69 74  E_OK && 0==sqlit
2640: 65 33 46 74 73 35 45 78 70 72 45 6f 66 28 70 45  e3Fts5ExprEof(pE
2650: 78 70 72 29 3b 0a 2a 2a 20 20 20 20 20 72 63 20  xpr);.**     rc 
2660: 3d 20 73 71 6c 69 74 65 33 46 74 73 35 45 78 70  = sqlite3Fts5Exp
2670: 72 4e 65 78 74 28 70 45 78 70 72 29 0a 2a 2a 20  rNext(pExpr).** 
2680: 29 7b 0a 2a 2a 20 20 20 2f 2f 20 54 68 65 20 64  ){.**   // The d
2690: 6f 63 75 6d 65 6e 74 20 77 69 74 68 20 72 6f 77  ocument with row
26a0: 69 64 20 69 52 6f 77 69 64 20 6d 61 74 63 68 65  id iRowid matche
26b0: 73 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e  s the expression
26c0: 21 0a 2a 2a 20 20 20 69 36 34 20 69 52 6f 77 69  !.**   i64 iRowi
26d0: 64 20 3d 20 73 71 6c 69 74 65 33 46 74 73 35 45  d = sqlite3Fts5E
26e0: 78 70 72 52 6f 77 69 64 28 70 45 78 70 72 29 3b  xprRowid(pExpr);
26f0: 0a 2a 2a 20 7d 0a 2a 2f 0a 69 6e 74 20 73 71 6c  .** }.*/.int sql
2700: 69 74 65 33 46 74 73 35 45 78 70 72 46 69 72 73  ite3Fts5ExprFirs
2710: 74 28 46 74 73 35 45 78 70 72 2a 2c 20 46 74 73  t(Fts5Expr*, Fts
2720: 35 49 6e 64 65 78 20 2a 70 49 64 78 2c 20 69 6e  5Index *pIdx, in
2730: 74 20 62 41 73 63 29 3b 0a 69 6e 74 20 73 71 6c  t bAsc);.int sql
2740: 69 74 65 33 46 74 73 35 45 78 70 72 4e 65 78 74  ite3Fts5ExprNext
2750: 28 46 74 73 35 45 78 70 72 2a 29 3b 0a 69 6e 74  (Fts5Expr*);.int
2760: 20 73 71 6c 69 74 65 33 46 74 73 35 45 78 70 72   sqlite3Fts5Expr
2770: 45 6f 66 28 46 74 73 35 45 78 70 72 2a 29 3b 0a  Eof(Fts5Expr*);.
2780: 69 36 34 20 73 71 6c 69 74 65 33 46 74 73 35 45  i64 sqlite3Fts5E
2790: 78 70 72 52 6f 77 69 64 28 46 74 73 35 45 78 70  xprRowid(Fts5Exp
27a0: 72 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74  r*);..void sqlit
27b0: 65 33 46 74 73 35 45 78 70 72 46 72 65 65 28 46  e3Fts5ExprFree(F
27c0: 74 73 35 45 78 70 72 2a 29 3b 0a 0a 2f 2a 20 43  ts5Expr*);../* C
27d0: 61 6c 6c 65 64 20 64 75 72 69 6e 67 20 73 74 61  alled during sta
27e0: 72 74 75 70 20 74 6f 20 72 65 67 69 73 74 65 72  rtup to register
27f0: 20 61 20 55 44 46 20 77 69 74 68 20 53 51 4c 69   a UDF with SQLi
2800: 74 65 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  te */.int sqlite
2810: 33 46 74 73 35 45 78 70 72 49 6e 69 74 28 73 71  3Fts5ExprInit(sq
2820: 6c 69 74 65 33 2a 29 3b 0a 0a 2f 2a 2a 2a 2a 2a  lite3*);../*****
2830: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2840: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2850: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 74  ******.** The ft
2860: 73 35 5f 65 78 70 72 2e 63 20 41 50 49 20 61 62  s5_expr.c API ab
2870: 6f 76 65 20 74 68 69 73 20 70 6f 69 6e 74 20 69  ove this point i
2880: 73 20 75 73 65 64 20 62 79 20 74 68 65 20 6f 74  s used by the ot
2890: 68 65 72 20 68 61 6e 64 2d 77 72 69 74 74 65 6e  her hand-written
28a0: 0a 2a 2a 20 43 20 63 6f 64 65 20 69 6e 20 74 68  .** C code in th
28b0: 69 73 20 6d 6f 64 75 6c 65 2e 20 54 68 65 20 69  is module. The i
28c0: 6e 74 65 72 66 61 63 65 73 20 62 65 6c 6f 77 20  nterfaces below 
28d0: 74 68 69 73 20 70 6f 69 6e 74 20 61 72 65 20 63  this point are c
28e0: 61 6c 6c 65 64 20 62 79 0a 2a 2a 20 74 68 65 20  alled by.** the 
28f0: 70 61 72 73 65 72 20 63 6f 64 65 20 69 6e 20 66  parser code in f
2900: 74 73 35 70 61 72 73 65 2e 79 2e 20 20 2a 2f 0a  ts5parse.y.  */.
2910: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73  .void sqlite3Fts
2920: 35 50 61 72 73 65 45 72 72 6f 72 28 46 74 73 35  5ParseError(Fts5
2930: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 63  Parse *pParse, c
2940: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 6d 74 2c  onst char *zFmt,
2950: 20 2e 2e 2e 29 3b 0a 0a 46 74 73 35 45 78 70 72   ...);..Fts5Expr
2960: 4e 6f 64 65 20 2a 73 71 6c 69 74 65 33 46 74 73  Node *sqlite3Fts
2970: 35 50 61 72 73 65 4e 6f 64 65 28 0a 20 20 46 74  5ParseNode(.  Ft
2980: 73 35 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c  s5Parse *pParse,
2990: 0a 20 20 69 6e 74 20 65 54 79 70 65 2c 0a 20 20  .  int eType,.  
29a0: 46 74 73 35 45 78 70 72 4e 6f 64 65 20 2a 70 4c  Fts5ExprNode *pL
29b0: 65 66 74 2c 0a 20 20 46 74 73 35 45 78 70 72 4e  eft,.  Fts5ExprN
29c0: 6f 64 65 20 2a 70 52 69 67 68 74 2c 0a 20 20 46  ode *pRight,.  F
29d0: 74 73 35 45 78 70 72 4e 65 61 72 73 65 74 20 2a  ts5ExprNearset *
29e0: 70 4e 65 61 72 0a 29 3b 0a 0a 46 74 73 35 45 78  pNear.);..Fts5Ex
29f0: 70 72 50 68 72 61 73 65 20 2a 73 71 6c 69 74 65  prPhrase *sqlite
2a00: 33 46 74 73 35 50 61 72 73 65 54 65 72 6d 28 0a  3Fts5ParseTerm(.
2a10: 20 20 46 74 73 35 50 61 72 73 65 20 2a 70 50 61    Fts5Parse *pPa
2a20: 72 73 65 2c 20 0a 20 20 46 74 73 35 45 78 70 72  rse, .  Fts5Expr
2a30: 50 68 72 61 73 65 20 2a 70 50 68 72 61 73 65 2c  Phrase *pPhrase,
2a40: 20 0a 20 20 46 74 73 35 54 6f 6b 65 6e 20 2a 70   .  Fts5Token *p
2a50: 54 6f 6b 65 6e 2c 0a 20 20 69 6e 74 20 62 50 72  Token,.  int bPr
2a60: 65 66 69 78 0a 29 3b 0a 0a 46 74 73 35 45 78 70  efix.);..Fts5Exp
2a70: 72 4e 65 61 72 73 65 74 20 2a 73 71 6c 69 74 65  rNearset *sqlite
2a80: 33 46 74 73 35 50 61 72 73 65 4e 65 61 72 73 65  3Fts5ParseNearse
2a90: 74 28 0a 20 20 46 74 73 35 50 61 72 73 65 2a 2c  t(.  Fts5Parse*,
2aa0: 20 0a 20 20 46 74 73 35 45 78 70 72 4e 65 61 72   .  Fts5ExprNear
2ab0: 73 65 74 2a 2c 0a 20 20 46 74 73 35 45 78 70 72  set*,.  Fts5Expr
2ac0: 50 68 72 61 73 65 2a 20 0a 29 3b 0a 0a 76 6f 69  Phrase* .);..voi
2ad0: 64 20 73 71 6c 69 74 65 33 46 74 73 35 50 61 72  d sqlite3Fts5Par
2ae0: 73 65 50 68 72 61 73 65 46 72 65 65 28 46 74 73  sePhraseFree(Fts
2af0: 35 45 78 70 72 50 68 72 61 73 65 2a 29 3b 0a 76  5ExprPhrase*);.v
2b00: 6f 69 64 20 73 71 6c 69 74 65 33 46 74 73 35 50  oid sqlite3Fts5P
2b10: 61 72 73 65 4e 65 61 72 73 65 74 46 72 65 65 28  arseNearsetFree(
2b20: 46 74 73 35 45 78 70 72 4e 65 61 72 73 65 74 2a  Fts5ExprNearset*
2b30: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46  );.void sqlite3F
2b40: 74 73 35 50 61 72 73 65 4e 6f 64 65 46 72 65 65  ts5ParseNodeFree
2b50: 28 46 74 73 35 45 78 70 72 4e 6f 64 65 2a 29 3b  (Fts5ExprNode*);
2b60: 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 74  ..void sqlite3Ft
2b70: 73 35 50 61 72 73 65 53 65 74 44 69 73 74 61 6e  s5ParseSetDistan
2b80: 63 65 28 46 74 73 35 50 61 72 73 65 2a 2c 20 46  ce(Fts5Parse*, F
2b90: 74 73 35 45 78 70 72 4e 65 61 72 73 65 74 2a 2c  ts5ExprNearset*,
2ba0: 20 46 74 73 35 54 6f 6b 65 6e 2a 29 3b 0a 76 6f   Fts5Token*);.vo
2bb0: 69 64 20 73 71 6c 69 74 65 33 46 74 73 35 50 61  id sqlite3Fts5Pa
2bc0: 72 73 65 53 65 74 43 6f 6c 75 6d 6e 28 46 74 73  rseSetColumn(Fts
2bd0: 35 50 61 72 73 65 2a 2c 20 46 74 73 35 45 78 70  5Parse*, Fts5Exp
2be0: 72 4e 65 61 72 73 65 74 2a 2c 20 46 74 73 35 54  rNearset*, Fts5T
2bf0: 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  oken*);.void sql
2c00: 69 74 65 33 46 74 73 35 50 61 72 73 65 46 69 6e  ite3Fts5ParseFin
2c10: 69 73 68 65 64 28 46 74 73 35 50 61 72 73 65 20  ished(Fts5Parse 
2c20: 2a 70 50 61 72 73 65 2c 20 46 74 73 35 45 78 70  *pParse, Fts5Exp
2c30: 72 4e 6f 64 65 20 2a 70 29 3b 0a 76 6f 69 64 20  rNode *p);.void 
2c40: 73 71 6c 69 74 65 33 46 74 73 35 50 61 72 73 65  sqlite3Fts5Parse
2c50: 4e 65 61 72 28 46 74 73 35 50 61 72 73 65 20 2a  Near(Fts5Parse *
2c60: 70 50 61 72 73 65 2c 20 46 74 73 35 54 6f 6b 65  pParse, Fts5Toke
2c70: 6e 2a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 45 6e 64  n*);.../*.** End
2c80: 20 6f 66 20 69 6e 74 65 72 66 61 63 65 20 74 6f   of interface to
2c90: 20 63 6f 64 65 20 69 6e 20 66 74 73 35 5f 65 78   code in fts5_ex
2ca0: 70 72 2e 63 2e 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  pr.c..**********
2cb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2cc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2cd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ce0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2cf0: 2f 0a 0a 23 65 6e 64 69 66 0a                    /..#endif.