X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_generate_hash_value.rst;h=5b835df9e6a48c1d710351abf533e8e3e3951cfe;hb=68ad48824e7162a490cce315756c5fa3f98d3e31;hp=b6f401e4c38bac2d4ec77b256e14ee0f07cc4da0;hpb=41543e45ff7aca5456c9279bc0403ecdc35f7b6e;p=m6w6%2Flibmemcached diff --git a/docs/memcached_generate_hash_value.rst b/docs/memcached_generate_hash_value.rst index b6f401e4..5b835df9 100644 --- a/docs/memcached_generate_hash_value.rst +++ b/docs/memcached_generate_hash_value.rst @@ -2,6 +2,7 @@ Generating hash values directly =============================== +.. index:: object: memcached_st Hash a key value @@ -12,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 @@ -25,17 +49,17 @@ DESCRIPTION ----------- -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 -memcached_behavior_set(). +:c:func:`memcached_behavior_set`. -memcached_generate_hash() takes a memcached_st struture and produces -the hash value that would have been generated based on the defaults -of the memcached_st structure. +: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 :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.