Memcac..._value(3pm)

📦
version 1.001801 · 7 versions
, in ubuntu stonking

✨ NAME ✨

memcached_generate_hash_value — hash a key value, bestie 💅

So like, the manual page is memcached_generate_hash_value(3pm) and it's filed under User Contributed Perl Documentation, and it lives to do exactly one (1) thing: turn your key into a hash. Slay.

📚 LIBRARY 📚

C Client Library for memcached (libmemcached, -lmemcached)

That's the vibe. Link against her, love her. 🫶

🎀 SYNOPSIS 🎀

#include <memcached.h>

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);

Two functions. Both return uint32_t. Both are iconic. Not me reading them over and over 🥹

💖 DESCRIPTION 💖

okay so first up, memcached_generate_hash_value() is the one that lets you hash a key using one of the hash functions defined in the library. The way that it's literally just here for the convenience of higher-level language bindings — like, if you're speaking Python or Ruby or whatever and you need to hash a key the memcached way, this is your girl. But for normal memcache operations? Highkey not necessary. Regular memcached stuff doesn't need you to call this. Periodt.

The allowed hash algorithm constants are listed in the manpage for memcached_behavior_set(). Go look there, bestie, the whole menu is on that page. 📋

Then there's memcached_generate_hash(), which takes a memcached_st struture and produces the hash value that would have been generated based on the defaults of the memcached_st structure. So like, it's showing you what hash you would have gotten, based on what that struct says. Note: yes, the original says "struture". Typo queen. We respect her. 👑

And a little history moment because it's important: as of version 0.36, all hash methods have been placed into the library libhashkit(3), which is linked with libmemcached(3). So that's the arrangement now. The hash stuff moved out and got linked back in. It's giving divorced parents but they're coparenting beautifully. 🦋

🔥 RETURN 🔥

You get back a 32-bit integer which is the result of hashing the given key.

Heads up though!!! For 64-bit hash algorithms, only the least-significant 32 bits are returned. Not the whole thing. Just those bottom bits. Do not @ me, that's literally what the manual says. 💀

🏠 HOME 🏠

To find out more information please check:

<https://launchpad.net/libmemcached>

That's home base. Go visit her. 🌸

👑 AUTHOR 👑

Brian Aker, <brian@tangent.org>

Thank you Brian, we love you, we appreciate you, no cap. 🙈

🌈 SEE ALSO 🌈

Read them too, iykyk. They're all connected, it's a whole family tree. 🧚

and that's the whole page bestie!! written by perl v5.42.3 and dated 2026-08-19 — so like, this documentation walked so we could run. thank u for coming to my ted talk 💜✨

📦 where this page comes from