CK_HT_ENTRY_KEY_LENGTH(3)

💖 CK_HT_ENTRY_KEY_LENGTH 💖

okay bestie, so this is a page from the Concurrency Kit manual — ck_ht_entry_key_length(3), aka the little function that tells you how long your key is. it's in libck, link it with -lck. let's get into it 💅

✨ NAME ✨

ck_ht_entry_key_length — returns the length of the key specified in the argument

like. it's giving "how many bytes is this key, ma'am". that's the whole job. 🎀

📚 LIBRARY 📚

Concurrency Kit (libck, -lck)

🦋 SYNOPSIS 🦋

#include <ck_ht.h>

uint16_t
ck_ht_entry_key_length(ck_ht_entry_t *entry);

🌸 DESCRIPTION 🌸

so ck_ht_entry_key_length() returns the length of the key that's associated with the object pointed to by the entry argument. that's it. that's the function. no cap. ✨

and here's the vibe check: it expects that entry is associated with a hash table that was initialized with CK_HT_MODE_BYTESTRING. so if your table isn't in bytestring mode… bestie. check ck_ht_init(3) for the deets before you come for this function. 🫶

🎀 RETURN VALUES 🎀

ck_ht_entry_key_length() returns 0 if the entry is empty. periodt.

💀 ERRORS 💀

Behavior is undefined if entry has not been initialized.

not "it might be weird", not "it'll probably be fine" — undefined. literally the void. initialize your entries, i am begging you 😭

👑 SEE ALSO 👑

the whole friend group, fr fr:

• 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_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_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)

Additional information available at http://concurrencykit.org/ 🌈

and that's the whole page, bestie 🧚 from the Concurrency Kit girlies, dated March 30, 2012 — mwah, go initialize your entries 💖🎀✨