CK_RHS_REBUILD(3)

✨ CK_RHS_REBUILD(3) ✨

okay bestie, gather round, because this little function is the glow-up your hash set has been begging for 💅 it lives in ck_rhs_rebuild and yes it's a real manual page from the Concurrency Kit (that's libck, link it with -lck) so let's get into it 🎀

🦋 NAME 🦋

ck_rhs_rebuild — rebuild a hash set. that's it. that's the whole job. iconic behavior fr ✨

🌸 LIBRARY 🌸

Concurrency Kit (aka libck, and you link it with -lck) 🫶

💖 SYNOPSIS 💖

#include <ck_rhs.h>

bool
ck_rhs_rebuild(ck_rhs_t *hs);

look at that signature. clean. minimal. main character energy 👑

✨ DESCRIPTION ✨

so like, the ck_rhs_rebuild(3) function will regenerate the hash set that hs is pointing at. lowkey a whole reset-and-refresh moment for your data structure 🧖♀️

and here's the tea: this has the side-effect of pruning degradatory side-effects of workloads that are delete heavy. so if your workload has been doing a lot of deleting, the hash set starts getting a lil crusty, and this is the self-care routine that fixes it. the regenerated hash set should have shorter probe sequences on average, which is the whole point — faster lookups, happier you, slay 💅

⚠️ but bestie, listen: this operation will require a significant amount of memory, and it is free to allocate a duplicate hash set in the rebuild process. so like, it might literally build a whole second copy of the set while it works. make sure you've got the room before you go doing all that 💀

🌈 RETURN VALUES 🌈

when it works out, ck_rhs_rebuild(3) returns true 🎉

and if it doesn't, it returns false 😭 that's the whole deal.

🍓 ERRORS 🍓

good news fr fr: this function will only return false if there are internal memory allocation failures. that's the only L it can take. no other drama 🙈

💜 SEE ALSO 💜

• ck_rhs_init(3)
• ck_rhs_move(3)
• ck_rhs_destroy(3)
• CK_RHS_HASH(3)
• ck_rhs_iterator_init(3)
• ck_rhs_next(3)
• ck_rhs_get(3)
• ck_rhs_put(3)
• ck_rhs_put_unique(3)
• ck_rhs_set(3)
• ck_rhs_fas(3)
• ck_rhs_gc(3)
• ck_rhs_grow(3)
• ck_rhs_remove(3)
• ck_rhs_count(3)
• ck_rhs_reset(3)
• ck_rhs_reset_size(3)
• ck_rhs_stat(3)

additional information available at http://concurrencykit.org/ — go peek, iykyk 🌐

and that's the whole page bestie!! this one's from Concurrency Kit, dated December 7, 2013, and it's filed under CK_RHS_REBUILD(3) 💖 go forth and rebuild those hash sets, you've totally got this 🦋✨🎀