/ Hex Artifact Content
Login

Artifact e7f0d761353996a8175eda351104acfde23afcb0:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 32 32 0a 2a 2a 0a 2a 2a 20 54 68  mber 22.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
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 2a 0a 2a 2a 20 54 68 69 73 20 69  ******.** This i
0180: 73 20 74 68 65 20 68 65 61 64 65 72 20 66 69 6c  s the header fil
0190: 65 20 66 6f 72 20 74 68 65 20 67 65 6e 65 72 69  e for the generi
01a0: 63 20 68 61 73 68 2d 74 61 62 6c 65 20 69 6d 70  c hash-table imp
01b0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a 20 75  lementation.** u
01c0: 73 65 64 20 69 6e 20 53 51 4c 69 74 65 2e 20 20  sed in SQLite.  
01d0: 57 65 27 76 65 20 6d 6f 64 69 66 69 65 64 20 69  We've modified i
01e0: 74 20 73 6c 69 67 68 74 6c 79 20 74 6f 20 73 65  t slightly to se
01f0: 72 76 65 20 61 73 20 61 20 73 74 61 6e 64 61 6c  rve as a standal
0200: 6f 6e 65 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c  one.** hash tabl
0210: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
0220: 20 66 6f 72 20 74 68 65 20 66 75 6c 6c 2d 74 65   for the full-te
0230: 78 74 20 69 6e 64 65 78 69 6e 67 20 6d 6f 64 75  xt indexing modu
0240: 6c 65 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 65  le..**.*/.#ifnde
0250: 66 20 5f 46 54 53 31 5f 48 41 53 48 5f 48 5f 0a  f _FTS1_HASH_H_.
0260: 23 64 65 66 69 6e 65 20 5f 46 54 53 31 5f 48 41  #define _FTS1_HA
0270: 53 48 5f 48 5f 0a 0a 2f 2a 20 46 6f 72 77 61 72  SH_H_../* Forwar
0280: 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 6f  d declarations o
0290: 66 20 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f  f structures. */
02a0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
02b0: 66 74 73 31 48 61 73 68 20 66 74 73 31 48 61 73  fts1Hash fts1Has
02c0: 68 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  h;.typedef struc
02d0: 74 20 66 74 73 31 48 61 73 68 45 6c 65 6d 20 66  t fts1HashElem f
02e0: 74 73 31 48 61 73 68 45 6c 65 6d 3b 0a 0a 2f 2a  ts1HashElem;../*
02f0: 20 41 20 63 6f 6d 70 6c 65 74 65 20 68 61 73 68   A complete hash
0300: 20 74 61 62 6c 65 20 69 73 20 61 6e 20 69 6e 73   table is an ins
0310: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c  tance of the fol
0320: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65  lowing structure
0330: 2e 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 6e 61  ..** The interna
0340: 6c 73 20 6f 66 20 74 68 69 73 20 73 74 72 75 63  ls of this struc
0350: 74 75 72 65 20 61 72 65 20 69 6e 74 65 6e 64 65  ture are intende
0360: 64 20 74 6f 20 62 65 20 6f 70 61 71 75 65 20 2d  d to be opaque -
0370: 2d 20 63 6c 69 65 6e 74 0a 2a 2a 20 63 6f 64 65  - client.** code
0380: 20 73 68 6f 75 6c 64 20 6e 6f 74 20 61 74 74 65   should not atte
0390: 6d 70 74 20 74 6f 20 61 63 63 65 73 73 20 6f 72  mpt to access or
03a0: 20 6d 6f 64 69 66 79 20 74 68 65 20 66 69 65 6c   modify the fiel
03b0: 64 73 20 6f 66 20 74 68 69 73 20 73 74 72 75 63  ds of this struc
03c0: 74 75 72 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79  ture.** directly
03d0: 2e 20 20 43 68 61 6e 67 65 20 74 68 69 73 20 73  .  Change this s
03e0: 74 72 75 63 74 75 72 65 20 6f 6e 6c 79 20 62 79  tructure only by
03f0: 20 75 73 69 6e 67 20 74 68 65 20 72 6f 75 74 69   using the routi
0400: 6e 65 73 20 62 65 6c 6f 77 2e 0a 2a 2a 20 48 6f  nes below..** Ho
0410: 77 65 76 65 72 2c 20 6d 61 6e 79 20 6f 66 20 74  wever, many of t
0420: 68 65 20 22 70 72 6f 63 65 64 75 72 65 73 22 20  he "procedures" 
0430: 61 6e 64 20 22 66 75 6e 63 74 69 6f 6e 73 22 20  and "functions" 
0440: 66 6f 72 20 6d 6f 64 69 66 79 69 6e 67 20 61 6e  for modifying an
0450: 64 0a 2a 2a 20 61 63 63 65 73 73 69 6e 67 20 74  d.** accessing t
0460: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 61 72  his structure ar
0470: 65 20 72 65 61 6c 6c 79 20 6d 61 63 72 6f 73 2c  e really macros,
0480: 20 73 6f 20 77 65 20 63 61 6e 27 74 20 72 65 61   so we can't rea
0490: 6c 6c 79 20 6d 61 6b 65 0a 2a 2a 20 74 68 69 73  lly make.** this
04a0: 20 73 74 72 75 63 74 75 72 65 20 6f 70 61 71 75   structure opaqu
04b0: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 66 74 73  e..*/.struct fts
04c0: 31 48 61 73 68 20 7b 0a 20 20 63 68 61 72 20 6b  1Hash {.  char k
04d0: 65 79 43 6c 61 73 73 3b 20 20 20 20 20 20 20 20  eyClass;        
04e0: 20 20 2f 2a 20 48 41 53 48 5f 49 4e 54 2c 20 5f    /* HASH_INT, _
04f0: 50 4f 49 4e 54 45 52 2c 20 5f 53 54 52 49 4e 47  POINTER, _STRING
0500: 2c 20 5f 42 49 4e 41 52 59 20 2a 2f 0a 20 20 63  , _BINARY */.  c
0510: 68 61 72 20 63 6f 70 79 4b 65 79 3b 20 20 20 20  har copyKey;    
0520: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69         /* True i
0530: 66 20 63 6f 70 79 20 6f 66 20 6b 65 79 20 6d 61  f copy of key ma
0540: 64 65 20 6f 6e 20 69 6e 73 65 72 74 20 2a 2f 0a  de on insert */.
0550: 20 20 69 6e 74 20 63 6f 75 6e 74 3b 20 20 20 20    int count;    
0560: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
0570: 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69  ber of entries i
0580: 6e 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a  n this table */.
0590: 20 20 66 74 73 31 48 61 73 68 45 6c 65 6d 20 2a    fts1HashElem *
05a0: 66 69 72 73 74 3b 20 20 20 20 2f 2a 20 54 68 65  first;    /* The
05b0: 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f   first element o
05c0: 66 20 74 68 65 20 61 72 72 61 79 20 2a 2f 0a 20  f the array */. 
05d0: 20 76 6f 69 64 20 2a 28 2a 78 4d 61 6c 6c 6f 63   void *(*xMalloc
05e0: 29 28 69 6e 74 29 3b 20 20 2f 2a 20 6d 61 6c 6c  )(int);  /* mall
05f0: 6f 63 28 29 20 66 75 6e 63 74 69 6f 6e 20 74 6f  oc() function to
0600: 20 75 73 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28   use */.  void (
0610: 2a 78 46 72 65 65 29 28 76 6f 69 64 20 2a 29 3b  *xFree)(void *);
0620: 20 20 2f 2a 20 66 72 65 65 28 29 20 66 75 6e 63    /* free() func
0630: 74 69 6f 6e 20 74 6f 20 75 73 65 20 2a 2f 0a 20  tion to use */. 
0640: 20 69 6e 74 20 68 74 73 69 7a 65 3b 20 20 20 20   int htsize;    
0650: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
0660: 65 72 20 6f 66 20 62 75 63 6b 65 74 73 20 69 6e  er of buckets in
0670: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
0680: 2a 2f 0a 20 20 73 74 72 75 63 74 20 5f 66 74 73  */.  struct _fts
0690: 31 68 74 20 7b 20 20 20 20 20 20 20 20 2f 2a 20  1ht {        /* 
06a0: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a  the hash table *
06b0: 2f 0a 20 20 20 20 69 6e 74 20 63 6f 75 6e 74 3b  /.    int count;
06c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
06d0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72  * Number of entr
06e0: 69 65 73 20 77 69 74 68 20 74 68 69 73 20 68 61  ies with this ha
06f0: 73 68 20 2a 2f 0a 20 20 20 20 66 74 73 31 48 61  sh */.    fts1Ha
0700: 73 68 45 6c 65 6d 20 2a 63 68 61 69 6e 3b 20 20  shElem *chain;  
0710: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f     /* Pointer to
0720: 20 66 69 72 73 74 20 65 6e 74 72 79 20 77 69 74   first entry wit
0730: 68 20 74 68 69 73 20 68 61 73 68 20 2a 2f 0a 20  h this hash */. 
0740: 20 7d 20 2a 68 74 3b 0a 7d 3b 0a 0a 2f 2a 20 45   } *ht;.};../* E
0750: 61 63 68 20 65 6c 65 6d 65 6e 74 20 69 6e 20 74  ach element in t
0760: 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 69 73  he hash table is
0770: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   an instance of 
0780: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a  the following .*
0790: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 41 6c  * structure.  Al
07a0: 6c 20 65 6c 65 6d 65 6e 74 73 20 61 72 65 20 73  l elements are s
07b0: 74 6f 72 65 64 20 6f 6e 20 61 20 73 69 6e 67 6c  tored on a singl
07c0: 65 20 64 6f 75 62 6c 79 2d 6c 69 6e 6b 65 64 20  e doubly-linked 
07d0: 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 41 67 61 69  list..**.** Agai
07e0: 6e 2c 20 74 68 69 73 20 73 74 72 75 63 74 75 72  n, this structur
07f0: 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  e is intended to
0800: 20 62 65 20 6f 70 61 71 75 65 2c 20 62 75 74 20   be opaque, but 
0810: 69 74 20 63 61 6e 27 74 20 72 65 61 6c 6c 79 0a  it can't really.
0820: 2a 2a 20 62 65 20 6f 70 61 71 75 65 20 62 65 63  ** be opaque bec
0830: 61 75 73 65 20 69 74 20 69 73 20 75 73 65 64 20  ause it is used 
0840: 62 79 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 73 74  by macros..*/.st
0850: 72 75 63 74 20 66 74 73 31 48 61 73 68 45 6c 65  ruct fts1HashEle
0860: 6d 20 7b 0a 20 20 66 74 73 31 48 61 73 68 45 6c  m {.  fts1HashEl
0870: 65 6d 20 2a 6e 65 78 74 2c 20 2a 70 72 65 76 3b  em *next, *prev;
0880: 20 2f 2a 20 4e 65 78 74 20 61 6e 64 20 70 72 65   /* Next and pre
0890: 76 69 6f 75 73 20 65 6c 65 6d 65 6e 74 73 20 69  vious elements i
08a0: 6e 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20  n the table */. 
08b0: 20 76 6f 69 64 20 2a 64 61 74 61 3b 20 20 20 20   void *data;    
08c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
08d0: 61 74 61 20 61 73 73 6f 63 69 61 74 65 64 20 77  ata associated w
08e0: 69 74 68 20 74 68 69 73 20 65 6c 65 6d 65 6e 74  ith this element
08f0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4b 65 79   */.  void *pKey
0900: 3b 20 69 6e 74 20 6e 4b 65 79 3b 20 20 20 20 20  ; int nKey;     
0910: 20 2f 2a 20 4b 65 79 20 61 73 73 6f 63 69 61 74   /* Key associat
0920: 65 64 20 77 69 74 68 20 74 68 69 73 20 65 6c 65  ed with this ele
0930: 6d 65 6e 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a  ment */.};../*.*
0940: 2a 20 54 68 65 72 65 20 61 72 65 20 32 20 64 69  * There are 2 di
0950: 66 66 65 72 65 6e 74 20 6d 6f 64 65 73 20 6f 66  fferent modes of
0960: 20 6f 70 65 72 61 74 69 6f 6e 20 66 6f 72 20 61   operation for a
0970: 20 68 61 73 68 20 74 61 62 6c 65 3a 0a 2a 2a 0a   hash table:.**.
0980: 2a 2a 20 20 20 46 54 53 31 5f 48 41 53 48 5f 53  **   FTS1_HASH_S
0990: 54 52 49 4e 47 20 20 20 20 20 20 20 20 70 4b 65  TRING        pKe
09a0: 79 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74  y points to a st
09b0: 72 69 6e 67 20 74 68 61 74 20 69 73 20 6e 4b 65  ring that is nKe
09c0: 79 20 62 79 74 65 73 20 6c 6f 6e 67 0a 2a 2a 20  y bytes long.** 
09d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
09e0: 20 20 20 20 20 20 20 20 20 20 28 69 6e 63 6c 75            (inclu
09f0: 64 69 6e 67 20 74 68 65 20 6e 75 6c 6c 2d 74 65  ding the null-te
0a00: 72 6d 69 6e 61 74 6f 72 2c 20 69 66 20 61 6e 79  rminator, if any
0a10: 29 2e 20 20 43 61 73 65 0a 2a 2a 20 20 20 20 20  ).  Case.**     
0a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0a30: 20 20 20 20 20 20 69 73 20 72 65 73 70 65 63 74        is respect
0a40: 65 64 20 69 6e 20 63 6f 6d 70 61 72 69 73 6f 6e  ed in comparison
0a50: 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 54 53 31 5f  s..**.**   FTS1_
0a60: 48 41 53 48 5f 42 49 4e 41 52 59 20 20 20 20 20  HASH_BINARY     
0a70: 20 20 20 70 4b 65 79 20 70 6f 69 6e 74 73 20 74     pKey points t
0a80: 6f 20 62 69 6e 61 72 79 20 64 61 74 61 20 6e 4b  o binary data nK
0a90: 65 79 20 62 79 74 65 73 20 6c 6f 6e 67 2e 20 0a  ey bytes long. .
0aa0: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  **              
0ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d               mem
0ac0: 63 6d 70 28 29 20 69 73 20 75 73 65 64 20 74 6f  cmp() is used to
0ad0: 20 63 6f 6d 70 61 72 65 20 6b 65 79 73 2e 0a 2a   compare keys..*
0ae0: 2a 0a 2a 2a 20 41 20 63 6f 70 79 20 6f 66 20 74  *.** A copy of t
0af0: 68 65 20 6b 65 79 20 69 73 20 6d 61 64 65 20 69  he key is made i
0b00: 66 20 74 68 65 20 63 6f 70 79 4b 65 79 20 70 61  f the copyKey pa
0b10: 72 61 6d 65 74 65 72 20 74 6f 20 66 74 73 31 48  rameter to fts1H
0b20: 61 73 68 49 6e 69 74 20 69 73 20 31 2e 20 20 0a  ashInit is 1.  .
0b30: 2a 2f 0a 23 64 65 66 69 6e 65 20 46 54 53 31 5f  */.#define FTS1_
0b40: 48 41 53 48 5f 53 54 52 49 4e 47 20 20 20 20 31  HASH_STRING    1
0b50: 0a 23 64 65 66 69 6e 65 20 46 54 53 31 5f 48 41  .#define FTS1_HA
0b60: 53 48 5f 42 49 4e 41 52 59 20 20 20 20 32 0a 0a  SH_BINARY    2..
0b70: 2f 2a 0a 2a 2a 20 41 63 63 65 73 73 20 72 6f 75  /*.** Access rou
0b80: 74 69 6e 65 73 2e 20 20 54 6f 20 64 65 6c 65 74  tines.  To delet
0b90: 65 2c 20 69 6e 73 65 72 74 20 61 20 4e 55 4c 4c  e, insert a NULL
0ba0: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 76 6f 69   pointer..*/.voi
0bb0: 64 20 73 71 6c 69 74 65 33 46 74 73 31 48 61 73  d sqlite3Fts1Has
0bc0: 68 49 6e 69 74 28 66 74 73 31 48 61 73 68 2a 2c  hInit(fts1Hash*,
0bd0: 20 69 6e 74 20 6b 65 79 74 79 70 65 2c 20 69 6e   int keytype, in
0be0: 74 20 63 6f 70 79 4b 65 79 29 3b 0a 76 6f 69 64  t copyKey);.void
0bf0: 20 2a 73 71 6c 69 74 65 33 46 74 73 31 48 61 73   *sqlite3Fts1Has
0c00: 68 49 6e 73 65 72 74 28 66 74 73 31 48 61 73 68  hInsert(fts1Hash
0c10: 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70  *, const void *p
0c20: 4b 65 79 2c 20 69 6e 74 20 6e 4b 65 79 2c 20 76  Key, int nKey, v
0c30: 6f 69 64 20 2a 70 44 61 74 61 29 3b 0a 76 6f 69  oid *pData);.voi
0c40: 64 20 2a 73 71 6c 69 74 65 33 46 74 73 31 48 61  d *sqlite3Fts1Ha
0c50: 73 68 46 69 6e 64 28 63 6f 6e 73 74 20 66 74 73  shFind(const fts
0c60: 31 48 61 73 68 2a 2c 20 63 6f 6e 73 74 20 76 6f  1Hash*, const vo
0c70: 69 64 20 2a 70 4b 65 79 2c 20 69 6e 74 20 6e 4b  id *pKey, int nK
0c80: 65 79 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65  ey);.void sqlite
0c90: 33 46 74 73 31 48 61 73 68 43 6c 65 61 72 28 66  3Fts1HashClear(f
0ca0: 74 73 31 48 61 73 68 2a 29 3b 0a 0a 2f 2a 0a 2a  ts1Hash*);../*.*
0cb0: 2a 20 53 68 6f 72 74 68 61 6e 64 20 66 6f 72 20  * Shorthand for 
0cc0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 62  the functions ab
0cd0: 6f 76 65 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66  ove.*/.#define f
0ce0: 74 73 31 48 61 73 68 49 6e 69 74 20 20 20 73 71  ts1HashInit   sq
0cf0: 6c 69 74 65 33 46 74 73 31 48 61 73 68 49 6e 69  lite3Fts1HashIni
0d00: 74 0a 23 64 65 66 69 6e 65 20 66 74 73 31 48 61  t.#define fts1Ha
0d10: 73 68 49 6e 73 65 72 74 20 73 71 6c 69 74 65 33  shInsert sqlite3
0d20: 46 74 73 31 48 61 73 68 49 6e 73 65 72 74 0a 23  Fts1HashInsert.#
0d30: 64 65 66 69 6e 65 20 66 74 73 31 48 61 73 68 46  define fts1HashF
0d40: 69 6e 64 20 20 20 73 71 6c 69 74 65 33 46 74 73  ind   sqlite3Fts
0d50: 31 48 61 73 68 46 69 6e 64 0a 23 64 65 66 69 6e  1HashFind.#defin
0d60: 65 20 66 74 73 31 48 61 73 68 43 6c 65 61 72 20  e fts1HashClear 
0d70: 20 73 71 6c 69 74 65 33 46 74 73 31 48 61 73 68   sqlite3Fts1Hash
0d80: 43 6c 65 61 72 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63  Clear../*.** Mac
0d90: 72 6f 73 20 66 6f 72 20 6c 6f 6f 70 69 6e 67 20  ros for looping 
0da0: 6f 76 65 72 20 61 6c 6c 20 65 6c 65 6d 65 6e 74  over all element
0db0: 73 20 6f 66 20 61 20 68 61 73 68 20 74 61 62 6c  s of a hash tabl
0dc0: 65 2e 20 20 54 68 65 20 69 64 69 6f 6d 20 69 73  e.  The idiom is
0dd0: 0a 2a 2a 20 6c 69 6b 65 20 74 68 69 73 3a 0a 2a  .** like this:.*
0de0: 2a 0a 2a 2a 20 20 20 66 74 73 31 48 61 73 68 20  *.**   fts1Hash 
0df0: 68 3b 0a 2a 2a 20 20 20 66 74 73 31 48 61 73 68  h;.**   fts1Hash
0e00: 45 6c 65 6d 20 2a 70 3b 0a 2a 2a 20 20 20 2e 2e  Elem *p;.**   ..
0e10: 2e 0a 2a 2a 20 20 20 66 6f 72 28 70 3d 66 74 73  ..**   for(p=fts
0e20: 31 48 61 73 68 46 69 72 73 74 28 26 68 29 3b 20  1HashFirst(&h); 
0e30: 70 3b 20 70 3d 66 74 73 31 48 61 73 68 4e 65 78  p; p=fts1HashNex
0e40: 74 28 70 29 29 7b 0a 2a 2a 20 20 20 20 20 53 6f  t(p)){.**     So
0e50: 6d 65 53 74 72 75 63 74 75 72 65 20 2a 70 44 61  meStructure *pDa
0e60: 74 61 20 3d 20 66 74 73 31 48 61 73 68 44 61 74  ta = fts1HashDat
0e70: 61 28 70 29 3b 0a 2a 2a 20 20 20 20 20 2f 2f 20  a(p);.**     // 
0e80: 64 6f 20 73 6f 6d 65 74 68 69 6e 67 20 77 69 74  do something wit
0e90: 68 20 70 44 61 74 61 0a 2a 2a 20 20 20 7d 0a 2a  h pData.**   }.*
0ea0: 2f 0a 23 64 65 66 69 6e 65 20 66 74 73 31 48 61  /.#define fts1Ha
0eb0: 73 68 46 69 72 73 74 28 48 29 20 20 28 28 48 29  shFirst(H)  ((H)
0ec0: 2d 3e 66 69 72 73 74 29 0a 23 64 65 66 69 6e 65  ->first).#define
0ed0: 20 66 74 73 31 48 61 73 68 4e 65 78 74 28 45 29   fts1HashNext(E)
0ee0: 20 20 20 28 28 45 29 2d 3e 6e 65 78 74 29 0a 23     ((E)->next).#
0ef0: 64 65 66 69 6e 65 20 66 74 73 31 48 61 73 68 44  define fts1HashD
0f00: 61 74 61 28 45 29 20 20 20 28 28 45 29 2d 3e 64  ata(E)   ((E)->d
0f10: 61 74 61 29 0a 23 64 65 66 69 6e 65 20 66 74 73  ata).#define fts
0f20: 31 48 61 73 68 4b 65 79 28 45 29 20 20 20 20 28  1HashKey(E)    (
0f30: 28 45 29 2d 3e 70 4b 65 79 29 0a 23 64 65 66 69  (E)->pKey).#defi
0f40: 6e 65 20 66 74 73 31 48 61 73 68 4b 65 79 73 69  ne fts1HashKeysi
0f50: 7a 65 28 45 29 20 28 28 45 29 2d 3e 6e 4b 65 79  ze(E) ((E)->nKey
0f60: 29 0a 0a 2f 2a 0a 2a 2a 20 4e 75 6d 62 65 72 20  )../*.** Number 
0f70: 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 20  of entries in a 
0f80: 68 61 73 68 20 74 61 62 6c 65 0a 2a 2f 0a 23 64  hash table.*/.#d
0f90: 65 66 69 6e 65 20 66 74 73 31 48 61 73 68 43 6f  efine fts1HashCo
0fa0: 75 6e 74 28 48 29 20 20 28 28 48 29 2d 3e 63 6f  unt(H)  ((H)->co
0fb0: 75 6e 74 29 0a 0a 23 65 6e 64 69 66 20 2f 2a 20  unt)..#endif /* 
0fc0: 5f 46 54 53 31 5f 48 41 53 48 5f 48 5f 20 2a 2f  _FTS1_HASH_H_ */
0fd0: 0a                                               .