X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_generate_hash_value.rst;h=5b835df9e6a48c1d710351abf533e8e3e3951cfe;hb=381c98f0967635bf58f70f6666c7f56dbf1b8e76;hp=7094f9f1e1be86d79891da1fa68eeccf29887ab5;hpb=281c398ba3a10af677494c4453cd09d85ca921e0;p=awesomized%2Flibmemcached diff --git a/docs/memcached_generate_hash_value.rst b/docs/memcached_generate_hash_value.rst index 7094f9f1..5b835df9 100644 --- a/docs/memcached_generate_hash_value.rst +++ b/docs/memcached_generate_hash_value.rst @@ -1,41 +1,47 @@ -.. highlight:: perl +=============================== +Generating hash values directly +=============================== +.. index:: object: memcached_st -memcached_generate_hash_value ----------------------------** +Hash a key value -Hash a key value +-------- +SYNOPSIS +-------- -******* -LIBRARY -******* +#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 Client Library for memcached (libmemcached, -lmemcached) +.. c:function:: uint32_t memcached_generate_hash (memcached_st *ptr, const char *key, size_t key_length) +.. c:type:: MEMCACHED_HASH_DEFAULT --------- -SYNOPSIS --------- +.. c:type:: MEMCACHED_HASH_MD5 +.. c:type:: MEMCACHED_HASH_CRC +.. c:type:: MEMCACHED_HASH_FNV1_64 -.. code-block:: perl +.. 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 - #include - - uint32_t - memcached_generate_hash_value (const char *key, - size_t key_length, - memcached_hash_t hash_algorithm); - - uint32_t - memcached_generate_hash (memcached_st *ptr, - const char *key, - size_t key_length); +Compile and link with -lmemcachedutil -lmemcached ----------- @@ -43,25 +49,25 @@ 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 -libmemcached(3) which is linked with libmemcached(3). +libhashkit(3) which is linked with libmemcached(3). For more information please see its documentation. -****** +------ RETURN -****** +------ A 32-bit integer which is the result of hashing the given key. @@ -69,18 +75,18 @@ For 64-bit hash algorithms, only the least-significant 32 bits are returned. -**** +---- HOME -**** +---- To find out more information please check: -`https://launchpad.net/libmemcached `_ +`http://libmemcached.org/ `_ -****** +------ AUTHOR -****** +------ Brian Aker,