| 1 |
#ifndef __JEKINS_HASH_H__ |
| 2 |
#define __JEKINS_HASH_H__ |
| 3 |
|
| 4 |
#include "hash.h" |
| 5 |
|
| 6 |
typedef struct __jenkins_state_t |
| 7 |
{ |
| 8 |
CMPH_HASH hashfunc; |
| 9 |
cmph_uint32 seed; |
| 10 |
} jenkins_state_t; |
| 11 |
|
| 12 |
jenkins_state_t *jenkins_state_new(cmph_uint32 size); //size of hash table |
| 13 |
|
| 14 |
/** \fn cmph_uint32 jenkins_hash(jenkins_state_t *state, const char *k, cmph_uint32 keylen); |
| 15 |
* \param state is a pointer to a jenkins_state_t structure |
| 16 |
* \param key is a pointer to a key |
| 17 |
* \param keylen is the key length |
| 18 |
* \return an integer that represents a hash value of 32 bits. |
| 19 |
*/ |
| 20 |
cmph_uint32 jenkins_hash(jenkins_state_t *state, const char *k, cmph_uint32 keylen); |
| 21 |
|
| 22 |
/** \fn void jenkins_hash_vector_(jenkins_state_t *state, const char *k, cmph_uint32 keylen, cmph_uint32 * hashes); |
| 23 |
* \param state is a pointer to a jenkins_state_t structure |
| 24 |
* \param key is a pointer to a key |
| 25 |
* \param keylen is the key length |
| 26 |
* \param hashes is a pointer to a memory large enough to fit three 32-bit integers. |
| 27 |
*/ |
| 28 |
void jenkins_hash_vector_(jenkins_state_t *state, const char *k, cmph_uint32 keylen, cmph_uint32 * hashes); |
| 29 |
|
| 30 |
void jenkins_state_dump(jenkins_state_t *state, char **buf, cmph_uint32 *buflen); |
| 31 |
jenkins_state_t *jenkins_state_copy(jenkins_state_t *src_state); |
| 32 |
jenkins_state_t *jenkins_state_load(const char *buf, cmph_uint32 buflen); |
| 33 |
void jenkins_state_destroy(jenkins_state_t *state); |
| 34 |
|
| 35 |
/** \fn void jenkins_state_pack(jenkins_state_t *state, void *jenkins_packed); |
| 36 |
* \brief Support the ability to pack a jenkins function into a preallocated contiguous memory space pointed by jenkins_packed. |
| 37 |
* \param state points to the jenkins function |
| 38 |
* \param jenkins_packed pointer to the contiguous memory area used to store the jenkins function. The size of jenkins_packed must be at least jenkins_state_packed_size() |
| 39 |
*/ |
| 40 |
void jenkins_state_pack(jenkins_state_t *state, void *jenkins_packed); |
| 41 |
|
| 42 |
/** \fn cmph_uint32 jenkins_state_packed_size(); |
| 43 |
* \brief Return the amount of space needed to pack a jenkins function. |
| 44 |
* \return the size of the packed function or zero for failures |
| 45 |
*/ |
| 46 |
cmph_uint32 jenkins_state_packed_size(void); |
| 47 |
|
| 48 |
|
| 49 |
/** \fn cmph_uint32 jenkins_hash_packed(void *jenkins_packed, const char *k, cmph_uint32 keylen); |
| 50 |
* \param jenkins_packed is a pointer to a contiguous memory area |
| 51 |
* \param key is a pointer to a key |
| 52 |
* \param keylen is the key length |
| 53 |
* \return an integer that represents a hash value of 32 bits. |
| 54 |
*/ |
| 55 |
cmph_uint32 jenkins_hash_packed(void *jenkins_packed, const char *k, cmph_uint32 keylen); |
| 56 |
|
| 57 |
/** \fn jenkins_hash_vector_packed(void *jenkins_packed, const char *k, cmph_uint32 keylen, cmph_uint32 * hashes); |
| 58 |
* \param jenkins_packed is a pointer to a contiguous memory area |
| 59 |
* \param key is a pointer to a key |
| 60 |
* \param keylen is the key length |
| 61 |
* \param hashes is a pointer to a memory large enough to fit three 32-bit integers. |
| 62 |
*/ |
| 63 |
void jenkins_hash_vector_packed(void *jenkins_packed, const char *k, cmph_uint32 keylen, cmph_uint32 * hashes); |
| 64 |
|
| 65 |
#endif |