CK_HS_RESET(3)

💖 CK_HS_RESET(3) — the ck_hs_reset glow-up 💖

okay bestie, so this is a page from the Concurrency Kit manual — that's manual section 3, <pink>CK_HS_RESET</pink> — and it's literally all about yeeting every single key out of a hash set. no cap. let's get into it 🧚✨

🌸 LIBRARY 🌸

Concurrency Kit, aka libck. link it with -lck and you're good 🫶

✨ SYNOPSIS ✨

#include <ck_hs.h>

bool
ck_hs_reset(ck_hs_t *hs);

💅 DESCRIPTION 💅

ck_hs_reset(3) removes all the keys stored in the hash set that hs points at. like, all of them. every last one. it's giving spring cleaning, it's giving factory reset, it's giving "we're starting over and we're not talking about it" 😭

the hash set you're clearing out is the one pointed to by the hs argument. that's the whole vibe. 💖

🦋 RETURN VALUES 🦋

• if it works out, ck_hs_reset(3) returns true ✅
• if it doesn't, it returns false 💀

and here's the tea: the only way this thing fails is if a replacement hash set could not be allocated internally. so if it says false, it's not being dramatic — something genuinely couldn't get allocated. 😤

🔥 ERRORS 🔥

⚠️ behavior is undefined if hs is uninitialized. do not pass her an uninitialized hash set, bestie, she will not survive it.

⚠️ behavior is undefined if this function is called by a non-writer thread. this is a writer-thread-only situation, periodt. if you're not the writer thread, stay in your lane 🙈

👑 SEE ALSO 👑

the whole friend group 🫶

• 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_get(3)
• ck_hs_put(3)
• ck_hs_put_unique(3)
• ck_hs_set(3)
• ck_hs_fas(3)
• ck_hs_remove(3)
• ck_hs_reset_size(3)
• ck_hs_grow(3)
• ck_hs_gc(3)
• ck_hs_rebuild(3)
• ck_hs_count(3)
• ck_hs_stat(3)

additional information is available at http://concurrencykit.org/ ✨

and that's the whole page, no notes 💅 this one's from the Concurrency Kit source, dated September 17, 2012 — vintage but still slaying, fr fr. mwah, go clear that hash set 🎀💖🌈