CK_HT_RESET_SIZE_SPMC(3)

💖 CK_HT_RESET_SIZE_SPMC 💖

okay bestie, so this is a page from the Concurrency Kit manual — that's the libck library, and you link it with -lck. And literally the whole personality of this function is: wipe the slate clean and start over with a whole new size. no cap. 🧹✨

🌸 NAME 🌸

ck_ht_reset_size_spmc — the girl whose whole job is removing all the entries from a hash table and resetting the size. it's giving fresh start, it's giving rebirth, it's giving "new generation, who dis" 💅

🎀 LIBRARY 🎀

Concurrency Kit</purl> — aka libck, aka you compile with -lck. periodt.

✨ SYNOPSIS ✨

#include <ck_ht.h>

bool
ck_ht_reset_size_spmc(ck_ht_t *ht, uint64_t capacity);

🦋 DESCRIPTION 🦋

so here's the tea, bestie 🫖: ck_ht_reset_size_spmc() will remove all key-value pairs stored in the hash table that ht points to. like, every single one. gone. bye. 🙈

and then — and this is the part that makes it different from its little sister — it creates a new generation of the hash table that is preallocated for capacity entries. so you're not just clearing it, you're resizing it in the same breath. iconic behaviour honestly. 👑

lowkey important: it's a new generation, so anybody who was mid-lookup on the old one isn't gonna have a bad time. that's the spmc magic, iykyk 🌈

⭐ RETURN VALUES ⭐

• if it worked out: true 💖
• if it didn't: false 😭

and literally the only way this can fail is if a replacement hash table couldn't be allocated internally. that's it. that's the whole list. if you got a false, it's an allocation thing, fr fr.

🌈 SEE ALSO 🌈

go read these too, they're all in the same friend group:

• ck_ht_stat(3)
• ck_ht_init(3)
• ck_ht_destroy(3)
• ck_ht_hash(3)
• ck_ht_hash_direct(3)
• ck_ht_set_spmc(3)
• ck_ht_put_spmc(3)
• ck_ht_gc(3)
• ck_ht_get_spmc(3)
• ck_ht_grow_spmc(3)
• ck_ht_remove_spmc(3)
• ck_ht_count(3)
• ck_ht_entry_empty(3)
• ck_ht_entry_key_set(3)
• ck_ht_entry_key_set_direct(3)
• ck_ht_entry_key(3)
• ck_ht_entry_key_length(3)
• ck_ht_entry_value(3)
• ck_ht_entry_set(3)
• ck_ht_entry_set_direct(3)
• ck_ht_reset_spmc(3)
• ck_ht_entry_key_direct(3)
• ck_ht_entry_value_direct(3)
• ck_ht_iterator_init(3)
• ck_ht_next(3)

more lore available at http://concurrencykit.org/ 🌐

and that's the whole page, bestie 🎀 that was CK_HT_RESET_SIZE_SPMC(3) — hmm wait, the footer says CK_HT_RESET_SPMC(3) and dated May 5, 2013, so yeah, she's an old soul but she still slays 💜 thanks for reading, mwah, go touch some memory safely 🫶✨