CK_HT_STAT(3)

💖 CK_HT_STAT(3) — get hash table status 💖

okay bestie, welcome to ck_ht_stat(3), the little gossip sesh where your hash table finally tells you how it's actually doing. this one lives in the Concurrency Kit — that's libck, and you link it with -lck, no cap ✨

🌸 SYNOPSIS 🌸

#include <ck_ht.h>

void
ck_ht_stat(ck_ht_t *ht, struct ck_ht_stat *st);

✨ DESCRIPTION ✨

so like. ck_ht_stat(3) rolls up to your hash set and is like "here's the tea" ☕ — it stores a bunch of hash set statistics into the object that st points at. that's it. that's the whole job. main character behavior tbh 👑

and the ck_ht_stat structure? she's a whole vibe, here's her exact fit:

struct ck_ht_stat {
        uint64_t probe_maximum; /* Longest read-side probe sequence. */
        uint64_t n_entries;     /* Current number of keys in hash set. */
};

so probe_maximum is the longest read-side probe sequence — literally how far the worst read had to go hunting 💀 — and n_entries is just how many keys are chilling in the hash set right now. iconic duo, fr fr 💅

🫶 RETURN VALUES 🫶

ck_ht_stat(3) has no return value. she gives you nothing back, she just fills in your struct and leaves. not me being unbothered and mysterious 😌

💀 ERRORS 💀

Behavior is undefined if ht has not been initialized.

like. genuinely. do not. initialize your ht first or it's giving chaos, it's giving ✨unpredictable✨, and not in the cute way 😭 this is a real warning, bestie, not a drill.

👑 SEE ALSO 👑

the whole friend group, one big group chat 💬:

• ck_ht_count(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_reset_spmc(3)
• ck_ht_reset_size_spmc(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_entry_key_direct(3)
• ck_ht_entry_value_direct(3)
• ck_ht_iterator_init(3)
• ck_ht_next(3)

and if you want even more lore, additional information is available at http://concurrencykit.org/ 🦋 go drink it up, iykyk 🌈

and that's a wrap on CK_HT_STAT(3), babes 🎀 this page is from September 17, 2012 — yeah, she's an elder but she ate and left no crumbs — courtesy of the Concurrency Kit source. stay initialized out there, bestie 💜✨