X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_generate_hash_value.rst;h=3da05dfd87a7f48551af4986c1a88ebb3cc02797;hb=9bfc8131a90eadb52d11b9ca06ff7fbe792c6a91;hp=7094f9f1e1be86d79891da1fa68eeccf29887ab5;hpb=281c398ba3a10af677494c4453cd09d85ca921e0;p=m6w6%2Flibmemcached diff --git a/docs/memcached_generate_hash_value.rst b/docs/memcached_generate_hash_value.rst index 7094f9f1..3da05dfd 100644 --- a/docs/memcached_generate_hash_value.rst +++ b/docs/memcached_generate_hash_value.rst @@ -1,41 +1,24 @@ -.. highlight:: perl - - -memcached_generate_hash_value ----------------------------** +=============================== +Generating hash values directly +=============================== +.. index:: object: memcached_st Hash a key value -******* -LIBRARY -******* - - -C Client Library for memcached (libmemcached, -lmemcached) - - +-------- +SYNOPSIS -------- -SYNOPSIS --------- - - -.. code-block:: perl - #include +#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); +.. 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); +Compile and link with -lmemcachedutil -lmemcached ----------- @@ -43,25 +26,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 the :c:type:`memcached_st structure`. 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 +52,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,