/ Hex Artifact Content
Login

Artifact 9a5b1be94664139f93217a0770d7144425cffb3a:


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 61 74 69 6f 6e 0a 2a 2a 20 75 73  lemenation.** us
01c0: 65 64 20 69 6e 20 53 51 4c 69 74 65 2e 20 20 57  ed in SQLite.  W
01d0: 65 27 76 65 20 6d 6f 64 69 66 69 65 64 20 69 74  e've modified it
01e0: 20 73 6c 69 67 68 74 6c 79 20 74 6f 20 73 65 72   slightly to ser
01f0: 76 65 20 61 73 20 61 20 73 74 61 6e 64 61 6c 6f  ve as a standalo
0200: 6e 65 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c 65  ne.** hash table
0210: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
0220: 66 6f 72 20 74 68 65 20 66 75 6c 6c 2d 74 65 78  for the full-tex
0230: 74 20 69 6e 64 65 78 69 6e 67 20 6d 6f 64 75 6c  t indexing modul
0240: 65 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 65 66  e..**.*/.#ifndef
0250: 20 5f 46 54 53 32 5f 48 41 53 48 5f 48 5f 0a 23   _FTS2_HASH_H_.#
0260: 64 65 66 69 6e 65 20 5f 46 54 53 32 5f 48 41 53  define _FTS2_HAS
0270: 48 5f 48 5f 0a 0a 2f 2a 20 46 6f 72 77 61 72 64  H_H_../* Forward
0280: 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 6f 66   declarations of
0290: 20 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f 0a   structures. */.
02a0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 66  typedef struct f
02b0: 74 73 32 48 61 73 68 20 66 74 73 32 48 61 73 68  ts2Hash fts2Hash
02c0: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ;.typedef struct
02d0: 20 66 74 73 32 48 61 73 68 45 6c 65 6d 20 66 74   fts2HashElem ft
02e0: 73 32 48 61 73 68 45 6c 65 6d 3b 0a 0a 2f 2a 20  s2HashElem;../* 
02f0: 41 20 63 6f 6d 70 6c 65 74 65 20 68 61 73 68 20  A complete hash 
0300: 74 61 62 6c 65 20 69 73 20 61 6e 20 69 6e 73 74  table is an inst
0310: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c  ance of the foll
0320: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e  owing structure.
0330: 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 6e 61 6c  .** The internal
0340: 73 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74  s of this struct
0350: 75 72 65 20 61 72 65 20 69 6e 74 65 6e 64 65 64  ure are intended
0360: 20 74 6f 20 62 65 20 6f 70 61 71 75 65 20 2d 2d   to be opaque --
0370: 20 63 6c 69 65 6e 74 0a 2a 2a 20 63 6f 64 65 20   client.** code 
0380: 73 68 6f 75 6c 64 20 6e 6f 74 20 61 74 74 65 6d  should not attem
0390: 70 74 20 74 6f 20 61 63 63 65 73 73 20 6f 72 20  pt to access or 
03a0: 6d 6f 64 69 66 79 20 74 68 65 20 66 69 65 6c 64  modify the field
03b0: 73 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74  s of this struct
03c0: 75 72 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e  ure.** directly.
03d0: 20 20 43 68 61 6e 67 65 20 74 68 69 73 20 73 74    Change this st
03e0: 72 75 63 74 75 72 65 20 6f 6e 6c 79 20 62 79 20  ructure only by 
03f0: 75 73 69 6e 67 20 74 68 65 20 72 6f 75 74 69 6e  using the routin
0400: 65 73 20 62 65 6c 6f 77 2e 0a 2a 2a 20 48 6f 77  es below..** How
0410: 65 76 65 72 2c 20 6d 61 6e 79 20 6f 66 20 74 68  ever, many of th
0420: 65 20 22 70 72 6f 63 65 64 75 72 65 73 22 20 61  e "procedures" a
0430: 6e 64 20 22 66 75 6e 63 74 69 6f 6e 73 22 20 66  nd "functions" f
0440: 6f 72 20 6d 6f 64 69 66 79 69 6e 67 20 61 6e 64  or modifying and
0450: 0a 2a 2a 20 61 63 63 65 73 73 69 6e 67 20 74 68  .** accessing th
0460: 69 73 20 73 74 72 75 63 74 75 72 65 20 61 72 65  is structure are
0470: 20 72 65 61 6c 6c 79 20 6d 61 63 72 6f 73 2c 20   really macros, 
0480: 73 6f 20 77 65 20 63 61 6e 27 74 20 72 65 61 6c  so we can't real
0490: 6c 79 20 6d 61 6b 65 0a 2a 2a 20 74 68 69 73 20  ly make.** this 
04a0: 73 74 72 75 63 74 75 72 65 20 6f 70 61 71 75 65  structure opaque
04b0: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 66 74 73 32  ..*/.struct fts2
04c0: 48 61 73 68 20 7b 0a 20 20 63 68 61 72 20 6b 65  Hash {.  char ke
04d0: 79 43 6c 61 73 73 3b 20 20 20 20 20 20 20 20 20  yClass;         
04e0: 20 2f 2a 20 48 41 53 48 5f 49 4e 54 2c 20 5f 50   /* HASH_INT, _P
04f0: 4f 49 4e 54 45 52 2c 20 5f 53 54 52 49 4e 47 2c  OINTER, _STRING,
0500: 20 5f 42 49 4e 41 52 59 20 2a 2f 0a 20 20 63 68   _BINARY */.  ch
0510: 61 72 20 63 6f 70 79 4b 65 79 3b 20 20 20 20 20  ar copyKey;     
0520: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
0530: 20 63 6f 70 79 20 6f 66 20 6b 65 79 20 6d 61 64   copy of key mad
0540: 65 20 6f 6e 20 69 6e 73 65 72 74 20 2a 2f 0a 20  e on insert */. 
0550: 20 69 6e 74 20 63 6f 75 6e 74 3b 20 20 20 20 20   int count;     
0560: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
0570: 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e  er of entries in
0580: 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20   this table */. 
0590: 20 66 74 73 32 48 61 73 68 45 6c 65 6d 20 2a 66   fts2HashElem *f
05a0: 69 72 73 74 3b 20 20 20 20 2f 2a 20 54 68 65 20  irst;    /* The 
05b0: 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66  first element of
05c0: 20 74 68 65 20 61 72 72 61 79 20 2a 2f 0a 20 20   the array */.  
05d0: 69 6e 74 20 68 74 73 69 7a 65 3b 20 20 20 20 20  int htsize;     
05e0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
05f0: 72 20 6f 66 20 62 75 63 6b 65 74 73 20 69 6e 20  r of buckets in 
0600: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a  the hash table *
0610: 2f 0a 20 20 73 74 72 75 63 74 20 5f 66 74 73 32  /.  struct _fts2
0620: 68 74 20 7b 20 20 20 20 20 20 20 20 2f 2a 20 74  ht {        /* t
0630: 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f  he hash table */
0640: 0a 20 20 20 20 69 6e 74 20 63 6f 75 6e 74 3b 20  .    int count; 
0650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0660: 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69   Number of entri
0670: 65 73 20 77 69 74 68 20 74 68 69 73 20 68 61 73  es with this has
0680: 68 20 2a 2f 0a 20 20 20 20 66 74 73 32 48 61 73  h */.    fts2Has
0690: 68 45 6c 65 6d 20 2a 63 68 61 69 6e 3b 20 20 20  hElem *chain;   
06a0: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20    /* Pointer to 
06b0: 66 69 72 73 74 20 65 6e 74 72 79 20 77 69 74 68  first entry with
06c0: 20 74 68 69 73 20 68 61 73 68 20 2a 2f 0a 20 20   this hash */.  
06d0: 7d 20 2a 68 74 3b 0a 7d 3b 0a 0a 2f 2a 20 45 61  } *ht;.};../* Ea
06e0: 63 68 20 65 6c 65 6d 65 6e 74 20 69 6e 20 74 68  ch element in th
06f0: 65 20 68 61 73 68 20 74 61 62 6c 65 20 69 73 20  e hash table is 
0700: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
0710: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a 2a  he following .**
0720: 20 73 74 72 75 63 74 75 72 65 2e 20 20 41 6c 6c   structure.  All
0730: 20 65 6c 65 6d 65 6e 74 73 20 61 72 65 20 73 74   elements are st
0740: 6f 72 65 64 20 6f 6e 20 61 20 73 69 6e 67 6c 65  ored on a single
0750: 20 64 6f 75 62 6c 79 2d 6c 69 6e 6b 65 64 20 6c   doubly-linked l
0760: 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 41 67 61 69 6e  ist..**.** Again
0770: 2c 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65  , this structure
0780: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20   is intended to 
0790: 62 65 20 6f 70 61 71 75 65 2c 20 62 75 74 20 69  be opaque, but i
07a0: 74 20 63 61 6e 27 74 20 72 65 61 6c 6c 79 0a 2a  t can't really.*
07b0: 2a 20 62 65 20 6f 70 61 71 75 65 20 62 65 63 61  * be opaque beca
07c0: 75 73 65 20 69 74 20 69 73 20 75 73 65 64 20 62  use it is used b
07d0: 79 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 73 74 72  y macros..*/.str
07e0: 75 63 74 20 66 74 73 32 48 61 73 68 45 6c 65 6d  uct fts2HashElem
07f0: 20 7b 0a 20 20 66 74 73 32 48 61 73 68 45 6c 65   {.  fts2HashEle
0800: 6d 20 2a 6e 65 78 74 2c 20 2a 70 72 65 76 3b 20  m *next, *prev; 
0810: 2f 2a 20 4e 65 78 74 20 61 6e 64 20 70 72 65 76  /* Next and prev
0820: 69 6f 75 73 20 65 6c 65 6d 65 6e 74 73 20 69 6e  ious elements in
0830: 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20   the table */.  
0840: 76 6f 69 64 20 2a 64 61 74 61 3b 20 20 20 20 20  void *data;     
0850: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
0860: 74 61 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  ta associated wi
0870: 74 68 20 74 68 69 73 20 65 6c 65 6d 65 6e 74 20  th this element 
0880: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b  */.  void *pKey;
0890: 20 69 6e 74 20 6e 4b 65 79 3b 20 20 20 20 20 20   int nKey;      
08a0: 2f 2a 20 4b 65 79 20 61 73 73 6f 63 69 61 74 65  /* Key associate
08b0: 64 20 77 69 74 68 20 74 68 69 73 20 65 6c 65 6d  d with this elem
08c0: 65 6e 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  ent */.};../*.**
08d0: 20 54 68 65 72 65 20 61 72 65 20 32 20 64 69 66   There are 2 dif
08e0: 66 65 72 65 6e 74 20 6d 6f 64 65 73 20 6f 66 20  ferent modes of 
08f0: 6f 70 65 72 61 74 69 6f 6e 20 66 6f 72 20 61 20  operation for a 
0900: 68 61 73 68 20 74 61 62 6c 65 3a 0a 2a 2a 0a 2a  hash table:.**.*
0910: 2a 20 20 20 46 54 53 32 5f 48 41 53 48 5f 53 54  *   FTS2_HASH_ST
0920: 52 49 4e 47 20 20 20 20 20 20 20 20 70 4b 65 79  RING        pKey
0930: 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 72   points to a str
0940: 69 6e 67 20 74 68 61 74 20 69 73 20 6e 4b 65 79  ing that is nKey
0950: 20 62 79 74 65 73 20 6c 6f 6e 67 0a 2a 2a 20 20   bytes long.**  
0960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0970: 20 20 20 20 20 20 20 20 20 28 69 6e 63 6c 75 64           (includ
0980: 69 6e 67 20 74 68 65 20 6e 75 6c 6c 2d 74 65 72  ing the null-ter
0990: 6d 69 6e 61 74 6f 72 2c 20 69 66 20 61 6e 79 29  minator, if any)
09a0: 2e 20 20 43 61 73 65 0a 2a 2a 20 20 20 20 20 20  .  Case.**      
09b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
09c0: 20 20 20 20 20 69 73 20 72 65 73 70 65 63 74 65       is respecte
09d0: 64 20 69 6e 20 63 6f 6d 70 61 72 69 73 6f 6e 73  d in comparisons
09e0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 54 53 32 5f 48  ..**.**   FTS2_H
09f0: 41 53 48 5f 42 49 4e 41 52 59 20 20 20 20 20 20  ASH_BINARY      
0a00: 20 20 70 4b 65 79 20 70 6f 69 6e 74 73 20 74 6f    pKey points to
0a10: 20 62 69 6e 61 72 79 20 64 61 74 61 20 6e 4b 65   binary data nKe
0a20: 79 20 62 79 74 65 73 20 6c 6f 6e 67 2e 20 0a 2a  y bytes long. .*
0a30: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  *               
0a40: 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63              memc
0a50: 6d 70 28 29 20 69 73 20 75 73 65 64 20 74 6f 20  mp() is used to 
0a60: 63 6f 6d 70 61 72 65 20 6b 65 79 73 2e 0a 2a 2a  compare keys..**
0a70: 0a 2a 2a 20 41 20 63 6f 70 79 20 6f 66 20 74 68  .** A copy of th
0a80: 65 20 6b 65 79 20 69 73 20 6d 61 64 65 20 69 66  e key is made if
0a90: 20 74 68 65 20 63 6f 70 79 4b 65 79 20 70 61 72   the copyKey par
0aa0: 61 6d 65 74 65 72 20 74 6f 20 66 74 73 32 48 61  ameter to fts2Ha
0ab0: 73 68 49 6e 69 74 20 69 73 20 31 2e 20 20 0a 2a  shInit is 1.  .*
0ac0: 2f 0a 23 64 65 66 69 6e 65 20 46 54 53 32 5f 48  /.#define FTS2_H
0ad0: 41 53 48 5f 53 54 52 49 4e 47 20 20 20 20 31 0a  ASH_STRING    1.
0ae0: 23 64 65 66 69 6e 65 20 46 54 53 32 5f 48 41 53  #define FTS2_HAS
0af0: 48 5f 42 49 4e 41 52 59 20 20 20 20 32 0a 0a 2f  H_BINARY    2../
0b00: 2a 0a 2a 2a 20 41 63 63 65 73 73 20 72 6f 75 74  *.** Access rout
0b10: 69 6e 65 73 2e 20 20 54 6f 20 64 65 6c 65 74 65  ines.  To delete
0b20: 2c 20 69 6e 73 65 72 74 20 61 20 4e 55 4c 4c 20  , insert a NULL 
0b30: 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 76 6f 69 64  pointer..*/.void
0b40: 20 73 71 6c 69 74 65 33 46 74 73 32 48 61 73 68   sqlite3Fts2Hash
0b50: 49 6e 69 74 28 66 74 73 32 48 61 73 68 2a 2c 20  Init(fts2Hash*, 
0b60: 69 6e 74 20 6b 65 79 74 79 70 65 2c 20 69 6e 74  int keytype, int
0b70: 20 63 6f 70 79 4b 65 79 29 3b 0a 76 6f 69 64 20   copyKey);.void 
0b80: 2a 73 71 6c 69 74 65 33 46 74 73 32 48 61 73 68  *sqlite3Fts2Hash
0b90: 49 6e 73 65 72 74 28 66 74 73 32 48 61 73 68 2a  Insert(fts2Hash*
0ba0: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b  , const void *pK
0bb0: 65 79 2c 20 69 6e 74 20 6e 4b 65 79 2c 20 76 6f  ey, int nKey, vo
0bc0: 69 64 20 2a 70 44 61 74 61 29 3b 0a 76 6f 69 64  id *pData);.void
0bd0: 20 2a 73 71 6c 69 74 65 33 46 74 73 32 48 61 73   *sqlite3Fts2Has
0be0: 68 46 69 6e 64 28 63 6f 6e 73 74 20 66 74 73 32  hFind(const fts2
0bf0: 48 61 73 68 2a 2c 20 63 6f 6e 73 74 20 76 6f 69  Hash*, const voi
0c00: 64 20 2a 70 4b 65 79 2c 20 69 6e 74 20 6e 4b 65  d *pKey, int nKe
0c10: 79 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  y);.void sqlite3
0c20: 46 74 73 32 48 61 73 68 43 6c 65 61 72 28 66 74  Fts2HashClear(ft
0c30: 73 32 48 61 73 68 2a 29 3b 0a 0a 2f 2a 0a 2a 2a  s2Hash*);../*.**
0c40: 20 53 68 6f 72 74 68 61 6e 64 20 66 6f 72 20 74   Shorthand for t
0c50: 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 62 6f  he functions abo
0c60: 76 65 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66 74  ve.*/.#define ft
0c70: 73 32 48 61 73 68 49 6e 69 74 20 20 20 73 71 6c  s2HashInit   sql
0c80: 69 74 65 33 46 74 73 32 48 61 73 68 49 6e 69 74  ite3Fts2HashInit
0c90: 0a 23 64 65 66 69 6e 65 20 66 74 73 32 48 61 73  .#define fts2Has
0ca0: 68 49 6e 73 65 72 74 20 73 71 6c 69 74 65 33 46  hInsert sqlite3F
0cb0: 74 73 32 48 61 73 68 49 6e 73 65 72 74 0a 23 64  ts2HashInsert.#d
0cc0: 65 66 69 6e 65 20 66 74 73 32 48 61 73 68 46 69  efine fts2HashFi
0cd0: 6e 64 20 20 20 73 71 6c 69 74 65 33 46 74 73 32  nd   sqlite3Fts2
0ce0: 48 61 73 68 46 69 6e 64 0a 23 64 65 66 69 6e 65  HashFind.#define
0cf0: 20 66 74 73 32 48 61 73 68 43 6c 65 61 72 20 20   fts2HashClear  
0d00: 73 71 6c 69 74 65 33 46 74 73 32 48 61 73 68 43  sqlite3Fts2HashC
0d10: 6c 65 61 72 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72  lear../*.** Macr
0d20: 6f 73 20 66 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f  os for looping o
0d30: 76 65 72 20 61 6c 6c 20 65 6c 65 6d 65 6e 74 73  ver all elements
0d40: 20 6f 66 20 61 20 68 61 73 68 20 74 61 62 6c 65   of a hash table
0d50: 2e 20 20 54 68 65 20 69 64 69 6f 6d 20 69 73 0a  .  The idiom is.
0d60: 2a 2a 20 6c 69 6b 65 20 74 68 69 73 3a 0a 2a 2a  ** like this:.**
0d70: 0a 2a 2a 20 20 20 66 74 73 32 48 61 73 68 20 68  .**   fts2Hash h
0d80: 3b 0a 2a 2a 20 20 20 66 74 73 32 48 61 73 68 45  ;.**   fts2HashE
0d90: 6c 65 6d 20 2a 70 3b 0a 2a 2a 20 20 20 2e 2e 2e  lem *p;.**   ...
0da0: 0a 2a 2a 20 20 20 66 6f 72 28 70 3d 66 74 73 32  .**   for(p=fts2
0db0: 48 61 73 68 46 69 72 73 74 28 26 68 29 3b 20 70  HashFirst(&h); p
0dc0: 3b 20 70 3d 66 74 73 32 48 61 73 68 4e 65 78 74  ; p=fts2HashNext
0dd0: 28 70 29 29 7b 0a 2a 2a 20 20 20 20 20 53 6f 6d  (p)){.**     Som
0de0: 65 53 74 72 75 63 74 75 72 65 20 2a 70 44 61 74  eStructure *pDat
0df0: 61 20 3d 20 66 74 73 32 48 61 73 68 44 61 74 61  a = fts2HashData
0e00: 28 70 29 3b 0a 2a 2a 20 20 20 20 20 2f 2f 20 64  (p);.**     // d
0e10: 6f 20 73 6f 6d 65 74 68 69 6e 67 20 77 69 74 68  o something with
0e20: 20 70 44 61 74 61 0a 2a 2a 20 20 20 7d 0a 2a 2f   pData.**   }.*/
0e30: 0a 23 64 65 66 69 6e 65 20 66 74 73 32 48 61 73  .#define fts2Has
0e40: 68 46 69 72 73 74 28 48 29 20 20 28 28 48 29 2d  hFirst(H)  ((H)-
0e50: 3e 66 69 72 73 74 29 0a 23 64 65 66 69 6e 65 20  >first).#define 
0e60: 66 74 73 32 48 61 73 68 4e 65 78 74 28 45 29 20  fts2HashNext(E) 
0e70: 20 20 28 28 45 29 2d 3e 6e 65 78 74 29 0a 23 64    ((E)->next).#d
0e80: 65 66 69 6e 65 20 66 74 73 32 48 61 73 68 44 61  efine fts2HashDa
0e90: 74 61 28 45 29 20 20 20 28 28 45 29 2d 3e 64 61  ta(E)   ((E)->da
0ea0: 74 61 29 0a 23 64 65 66 69 6e 65 20 66 74 73 32  ta).#define fts2
0eb0: 48 61 73 68 4b 65 79 28 45 29 20 20 20 20 28 28  HashKey(E)    ((
0ec0: 45 29 2d 3e 70 4b 65 79 29 0a 23 64 65 66 69 6e  E)->pKey).#defin
0ed0: 65 20 66 74 73 32 48 61 73 68 4b 65 79 73 69 7a  e fts2HashKeysiz
0ee0: 65 28 45 29 20 28 28 45 29 2d 3e 6e 4b 65 79 29  e(E) ((E)->nKey)
0ef0: 0a 0a 2f 2a 0a 2a 2a 20 4e 75 6d 62 65 72 20 6f  ../*.** Number o
0f00: 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 20 68  f entries in a h
0f10: 61 73 68 20 74 61 62 6c 65 0a 2a 2f 0a 23 64 65  ash table.*/.#de
0f20: 66 69 6e 65 20 66 74 73 32 48 61 73 68 43 6f 75  fine fts2HashCou
0f30: 6e 74 28 48 29 20 20 28 28 48 29 2d 3e 63 6f 75  nt(H)  ((H)->cou
0f40: 6e 74 29 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 5f  nt)..#endif /* _
0f50: 46 54 53 32 5f 48 41 53 48 5f 48 5f 20 2a 2f 0a  FTS2_HASH_H_ */.