CK_HS_GROW(3)

💖 CK_HS_GROW 💖

okay bestie, gather round, because we're about to talk about the glow-up function of the Concurrency Kit hash set world 🦋

This page lives in the Concurrency Kit — that's libck, and you link it with -lck, no cap 💅

✨ SYNOPSIS ✨

#include <ck_hs.h>

bool
ck_hs_grow(ck_hs_t *hs, unsigned long capacity);

🌸 DESCRIPTION 🌸

So ck_hs_grow(3) is literally the function that makes your hash set ✨bigger✨. It resizes the hash set so it can store at least the number of entries you pass in as capacity — and it does that at a load factor of one. iconic behavior honestly 👑

quick lil reminder though: the default hash set load factor is 0.5, not 1. so yeah, she's a little roomier than default by design 🫶

now here's the tea ☕ — if you want to minimize the likelihood of memory allocations for a hash set that's meant to store n entries, then you should specify a capacity of 2n. that's the move, fr fr.

and one more thing: the default behavior of ck_hs is to round capacity up to the next power of two if it's not already a power of two. so don't be surprised when your cute lil number comes back different 💀 it's giving mathematically responsible.

💜 RETURN VALUES 💜

• If everything goes great, ck_hs_grow(3) returns true 🎀
• If it does not go great, it returns false 😭

that's it. that's the whole vibe check.

🙈 ERRORS 🙈

⚠️ Behavior is undefined if hs is uninitialized. like, genuinely undefined. don't do it. this is not a drill, bestie 💀

and the only reason this function will return false is if there are internal memory allocation failures. so if it fails, it's not you, it's the memory 🌈

👑 SEE ALSO 👑

the whole squad, obviously:

• 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_rebuild(3)
• ck_hs_gc(3)
• ck_hs_count(3)
• ck_hs_reset(3)
• ck_hs_reset_size(3)
• ck_hs_stat(3)

and if you want even more, there's additional information available at http://concurrencykit.org/ 🌐

okay that's the whole page, ily, go grow your hash set responsibly 💖✨🎀🦋🌸💅🫶

this lil masterpiece was dated September 17, 2012, and it's the CK_HS_GROW(3) page — periodt. 💜