CK_HT_NEXT(3)

💖 CK_HT_NEXT(3) 💖

okay so bestie, this is the page for ck_ht_next — the one from the CK_HT_NEXT(3) manual — and it's literally the "gimme the next one" function. no cap, it's giving little engine that could, but for hash tables. 🚂✨

🌸 NAME 🌸

ck_ht_next — iterate to next entry in hash table

🎀 LIBRARY 🎀

Concurrency Kit (libck, -lck)

like. link against it. that's the vibe. 💅

✨ SYNOPSIS ✨

#include <ck_ht.h>

bool
ck_ht_next(ck_ht_t *ht, ck_ht_iterator_t *iterator,
    ck_ht_entry_t **entry);

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — ck_ht_next() bumps the iterator object that iterator points at forward, so it lands on the next non-empty hash table entry. skipping the empty ones, iconic behaviour, we love a function that doesn't waste our time. 💅

and if ck_ht_next() returns true?? then the pointer that entry points to gets initialized to the current hash table entry that the iterator object is pointing at. slay. 🫶

🚨 bestie listen — it is expected that iterator has already been initialized with the ck_ht_iterator_init(3) function, or statically initialized using CK_HT_ITERATOR_INITIALIZER. do not just roll up with a random uninitialized iterator, that's not the move. 🙈

💫 RETURN VALUES 💫

• if ck_ht_next() returns true → the object pointed to by entry points to a valid hash table entry. go off. 🔥
• if ck_ht_next() returns false → the value of the object pointed to by entry is undefined. 😭 so like, don't look at it. avert your eyes. it's giving void.

💀 ERRORS 💀

Behavior is undefined if iterator or ht are uninitialized. fr fr. undefined behaviour is not a cute look, it's the main character dying in episode 3. 🪦

👑 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_key_set(3)
• ck_ht_entry_key_set_direct(3)
• ck_ht_entry_key_length(3)
• ck_ht_entry_key(3)
• ck_ht_entry_set(3)
• ck_ht_entry_set_direct(3)
• ck_ht_entry_key_direct(3)
• ck_ht_entry_value(3)
• ck_ht_entry_value_direct(3)
• ck_ht_iterator_init(3)

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

and that's the whole page bestie, we ate and left no crumbs 💖✨

this one's from the Concurrency Kit source, dated March 30, 2012 — yeah she's vintage, she's a classic, she's been slaying since 2012 and she's still here. periodt. 👑🎀