jenkinshash.H File Reference

---

Detailed Description

32-bit hash functions (NOT CRYPTOGRAPHIC!)

Definition in file jenkinshash.H.

#include "Util/Types.H"

Include dependency graph for jenkinshash.H:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
uint32	jenkinshash (const byte *key, uint32 length, uint32 initval=0)
	hash a variable-length key into a 32-bit value
uint32	jenkinshash2 (const uint32 *key, uint32 length, uint32 initval=0)
	Hash a variable-length key into a 32-bit value.

---

Function Documentation

uint32 jenkinshash (  const byte *  key, uint32  length, uint32  initval = 0 )

hash a variable-length key into a 32-bit value k : the key (the unaligned variable-length array of bytes) len : the length of the key, counting by bytes level : can be any 4-byte value Returns a 32-bit value. Every bit of the key affects every bit of the return value. Every 1-bit and 2-bit delta achieves avalanche. About 36+6len instructions. The best hash table sizes are powers of 2. There is no need to do mod a prime (mod is sooo slow!). If you need less than 32 bits, use a bitmask. For example, if you need only 10 bits, do h = (h & hashmask(10)); In which case, the hash table should have hashsize(10) elements. If you are hashing n strings (ub1 **)k, do it like this: for (i=0, h=0; i<n; ++i) h = hash( k[i], len[i], h); By Bob Jenkins, 1996. bob_jenkins@burtleburtle.net. You may use this code any way you wish, private, educational, or commercial. It's free. See http://burlteburtle.net/bob/hash/evahash.html Use for hash table lookup, or anything where one collision in 2^32 is acceptable. Do NOT use for cryptographic purposes. Definition at line 442 of file jenkinshash.C. References GVX_TRACE, and hash(). Referenced by HashOutputSeries::Impl::printHash().

uint32 jenkinshash2 (  const uint32 *  key, uint32  length, uint32  initval = 0 )

Hash a variable-length key into a 32-bit value. This works on all machines. jenkinshash2() is identical to jenkinshash() on little-endian machines, except that the length has to be measured in ub4s instead of bytes. It is much faster than hash(). It requires -- that the key be an array of ub4's, and -- that all your machines have the same endianness, and -- that the length be the number of ub4's in the key Definition at line 448 of file jenkinshash.C. References GVX_TRACE, and hash2().

---