
		 .:. Bob Jenkins hash functions for PHP .:.
			Documentation for version 0.9


	   ------------------------ BLURB ------------------------


This PHP extension implements a super fast function for hash table lookups.
The function works on keys of any size with a very low risk of collisions.

For more info about that function, please have a look at:
http://www.burtleburtle.net/bob/hash/doobs.html


       ------------------------ INSTALLATION ------------------------
       
       
Before all, if you are running Debian, install the php5-dev and the autoconf
packages.

Then, install and compile like any standard PHP extension:       

phpize
./configure --enable-jenkins
make
make install

Then edit your php.ini file in order to add:

extension=jenkins.so


	   ------------------------ USAGE ------------------------
	   
	   
* Get the 32-bits hash of a random string:

$hash = jenkins_hash($string);

* Get the 64-bits hash of a random string, if PHP is running on a 64-bits
operating system:

$hash = jenkins_hash64($string);

* Get the hexadecimal 64-bits hash of a random string:

$hex_hash = jenkins_hash64_hex($string);


       ------------------------ DISTRIBUTION ------------------------
	   
	   
Hash functions by Bob Jenkins, May 2006, Public domain.

PHP extension by Frank Denis <j at pureftpd dot org>, December 2007,
Public domain.

The PHP extension can be downloaded from:

http://download.pureftpd.org/pure-ftpd/misc/php-jenkins-hash/


