CK_HT_ENTRY_SET(3)

✨ CK_HT_ENTRY_SET(3) ✨

okay bestie, welcome to the ck_ht_entry_set page 💖 this one lives in the Concurrency Kit (that's libck, and you link it with -lck btw) and it's genuinely one of the more chill functions in the whole hash table friend group. no drama, no return value, no errors. she just does her thing. iconic behavior honestly 🎀

🌸 NAME 🌸

ck_ht_entry_set — initialize a key-value pair

like. that's it. that's the job. she sets an entry. she's the moment. 💅

🦋 LIBRARY 🦋

Concurrency Kit (libck, -lck)

✨ SYNOPSIS ✨

#include <ck_ht.h>

void
ck_ht_entry_set(ck_ht_entry_t *entry, ck_ht_hash_t h, const void *key,
    uint16_t key_length, const void *value);

look at her go. five arguments, zero returns, all vibes. 🌈

💜 DESCRIPTION 💜

so here's the tea, bestie 🍓 — ck_ht_entry_set() takes the object that entry points at and initializes it. like, fully glows it up. it gets:

• a key, which is whatever key points at 👑
• a value, which is whatever value points at 💖
• and the length of that key, which you hand over in key_length 📏

and about that key_length — the maximum value it can be is defined by the CK_HT_KEY_LENGTH macro. that's the ceiling. respect the ceiling. no cap (well, actually, cap, but like. the macro one) 🙈

now, when do you actually reach for this? the classic move is initializing an entry so you can feed it to ck_ht_set_spmc(3) and ck_ht_put_spmc(3). those are the operations that do stuff with it. ck_ht_entry_set() is the little pre-game ritual ✨

also important: it is expected that this entry will be associated with a hash table that was initialized with CK_HT_MODE_BYTESTRING — peep ck_ht_init(3) if you want the full lore. so like, don't just roll up with any old table, she has a type and her type is bytestring mode 🫶

⭐ RETURN VALUES ⭐

ck_ht_entry_set() has no return value.

nothing. void. she gives you nothing and somehow that's still serving 💀

🧚 ERRORS 🧚

This function will never fail.

not "unlikely to fail." not "fails gracefully." never fails. she simply cannot be stopped. main character energy fr fr 🔥

👑 SEE ALSO 👑

the whole squad, all of them, no one left behind 💕

• 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_set_direct(3)
• ck_ht_entry_key(3)
• ck_ht_entry_key_length(3)
• ck_ht_entry_value(3)
• ck_ht_entry_key_set(3)
• ck_ht_entry_key_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/ 🌐

ok that's the whole page bestie, go forth and initialize your entries responsibly 🫶

and that's a wrap!! this one's from Concurrency Kit, dated March 30, 2012 — yeah she's an elder but she's still that girl 💅✨ no cap.