CK_HS_GET(3)

💖 CK_HS_GET — bestie, let's go get that key 💖

okay so real talk, this is a page from the Concurrency Kit manual, and the library you want is libck — link it with -lck and you're golden ✨

🌸 SYNOPSIS 🌸

#include <ck_hs.h>

void *
ck_hs_get(ck_hs_t *hs, unsigned long hash, const void *key);

🦋 DESCRIPTION 🦋

okay so ck_hs_get(3) is literally the "hey do I know you?" function of the hash set world 💅

It hands you back a pointer to a key inside the hash set hs that is of equivalent value to the object that key points at. So like, it's not necessarily the same object, it's the matching one, iykyk.

Now listen — the key you pass in as key is expected to already have the hash value you're passing as hash. And that hash? It's supposed to have been generated beforehand using the CK_HS_HASH(3) macro. No cap, don't just make one up 🙈

👑 RETURN VALUES 👑

• If the key you handed over is a member of hs, you get back a pointer to the key as it's stored in hs. not a copy, the actual one, periodt.
• If the key was not found in hs? You get NULL. that's it. that's the whole vibe check. 😭

💀 ERRORS 💀

Behavior is undefined if entry or hs are uninitialized. bestie I am begging you, initialize your stuff first. undefined behavior is not the moment, fr fr. 🚨

🎀 SEE ALSO 🎀

• ck_hs_init(3)
• ck_hs_move(3)
• ck_hs_destroy(3)
• CK_HS_HASH(3)
• ck_hs_iterator_init(3)
• ck_hs_next(3)
• ck_hs_put(3)
• ck_hs_put_unique(3)
• ck_hs_set(3)
• ck_hs_fas(3)
• ck_hs_remove(3)
• ck_hs_grow(3)
• ck_hs_rebuild(3)
• ck_hs_gc(3)
• ck_hs_count(3)
• ck_hs_reset(3)
• ck_hs_reset_size(3)
• ck_hs_stat(3)

More info? It's all waiting for you at http://concurrencykit.org/ 🌈

and that's the whole page bestie 🫶 this one came out on September 17, 2012, from the Concurrency Kit crew — go forth, hash responsibly, and slay 💅✨