Go to file
Jason Davies 98745832e8 Fix initial buffer size calculation. 2011-12-07 23:10:36 +00:00
test Better UTF-8 hashing, and more tests. 2011-12-07 11:42:48 +00:00
.npmignore Add .npmignore and bump version. 2011-12-07 11:55:04 +00:00
LICENSE Bloom filter in JavaScript using FNV hash. 2011-09-04 10:25:02 +01:00
README.md Update README. 2011-12-07 23:09:26 +00:00
bloomfilter.js Fix initial buffer size calculation. 2011-12-07 23:10:36 +00:00
package.json Fix initial buffer size calculation. 2011-12-07 23:10:36 +00:00

README.md

Bloom Filter

This JavaScript bloom filter implementation uses the non-cryptographic FowlerNollVo hash function for speed.

Usage

var bloom = new BloomFilter(
  32 * 256, // number of bits to allocate.
  16        // number of hash functions.
);

// Add some elements to the filter.
bloom.add("foo");
bloom.add("bar");

// Test if an item is in our filter.
// Returns true if an item is probably in the set,
// or false if an item is definitely not in the set.
bloom.test("foo");
bloom.test("bar");
bloom.test("blah");

Implementation

Although the bloom filter requires k hash functions, we can simulate this using only two hash functions. In fact, we cheat and get the second hash function almost for free by iterating once more on the first hash using the FNV hash algorithm.

Thanks to Will Fitzgerald for his help and inspiration with the hashing optimisation.