X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_generate_hash_value.rst;h=5b835df9e6a48c1d710351abf533e8e3e3951cfe;hb=4018da61ccc84a5345b19b61a1cfd5a30df896ea;hp=3da05dfd87a7f48551af4986c1a88ebb3cc02797;hpb=50dc8599f105fe915607e6f2d57851fd9acad839;p=m6w6%2Flibmemcached diff --git a/docs/memcached_generate_hash_value.rst b/docs/memcached_generate_hash_value.rst index 3da05dfd..5b835df9 100644 --- a/docs/memcached_generate_hash_value.rst +++ b/docs/memcached_generate_hash_value.rst @@ -13,10 +13,33 @@ SYNOPSIS #include + +.. c:type:: memcached_hash_t -.. c:function:: uint32_t memcached_generate_hash_value (const char *key, size_t key_length, memcached_hash_t hash_algorithm); +.. c:function:: uint32_t memcached_generate_hash_value (const char *key, size_t key_length, memcached_hash_t hash_algorithm) + +.. c:function:: uint32_t memcached_generate_hash (memcached_st *ptr, const char *key, size_t key_length) + +.. c:type:: MEMCACHED_HASH_DEFAULT + +.. c:type:: MEMCACHED_HASH_MD5 + +.. c:type:: MEMCACHED_HASH_CRC + +.. c:type:: MEMCACHED_HASH_FNV1_64 + +.. c:type:: MEMCACHED_HASH_FNV1A_64 + +.. c:type:: MEMCACHED_HASH_FNV1_32 + +.. c:type:: MEMCACHED_HASH_FNV1A_32 + +.. c:type:: MEMCACHED_HASH_JENKINS + +.. c:type:: MEMCACHED_HASH_MURMUR + +.. c:type:: MEMCACHED_HASH_HSIEH -.. c:function:: uint32_t memcached_generate_hash (memcached_st *ptr, const char *key, size_t key_length); Compile and link with -lmemcachedutil -lmemcached @@ -26,17 +49,17 @@ DESCRIPTION ----------- -:c:func:`memcached_generate_hash_value()` allows you to hash a key using one of +:c:func:`memcached_generate_hash_value` allows you to hash a key using one of the hash functions defined in the library. This method is provided for the convenience of higher-level language bindings and is not necessary for normal memcache operations. The allowed hash algorithm constants are listed in the manpage for -:c:func:`memcached_behavior_set()`. +:c:func:`memcached_behavior_set`. -:c:func:`memcached_generate_hash()` takes a :c:type:`memcached_st` struture +:c:func:`memcached_generate_hash` takes a :c:type:`memcached_st` struture and produces the hash value that would have been generated based on the -defaults of the :c:type:`memcached_st structure`. +defaults of :c:type:`memcached_st`. As of version 0.36 all hash methods have been placed into the library libhashkit(3) which is linked with libmemcached(3). For more information please see its documentation.