CK_RHS_APPLY(3)

💖 CK_RHS_APPLY(3) 💖

okay bestie, welcome to the ck_rhs_apply(3) page — this is the Concurrency Kit one, and honestly? it's giving "let me just casually reach into a hash set and do a lil something to a value" ✨

🌸 NAME 🌸

ck_rhs_apply — apply a function to hash set value 💅

📚 LIBRARY 📚

Concurrency Kit (libck, -lck) 🫶

✨ SYNOPSIS ✨

#include <ck_rhs.h>

void *
ck_rhs_apply_fn_t(void *key, void *closure);

bool
ck_rhs_apply(ck_rhs_t *hs, unsigned long hash, const void *key,
    ck_rhs_apply_fn_t *function, void *argument);

💜 DESCRIPTION 💜

so here's the tea ☕ — ck_rhs_apply(3) goes and looks up the hash set slot that's associated with key, and then it hands that slot over to the function pointed to by function so it can do its lil thing 🔥

and like, this callback is lowkey powerful: it can remove or replace the value. how? by returning NULL to remove it, or by returning a pointer to another object that has an identical key to replace it. iconic behaviour, no cap 👑

the first argument that gets passed to function is a pointer to the object that was found in the hash set, and the second argument is the argument pointer that you passed in to ck_rhs_apply(3) itself. cute, right? 🎀

and if the pointer that function returns is equivalent to that first argument? then literally nothing happens — no modification is made to the hash set. it's giving "we're good, no changes needed" 🙈

🌈 RETURN VALUES 🌈

• if it all goes well, ck_rhs_apply(3) returns true 💖
• otherwise it returns false on failure 😭

🦋 SEE ALSO 🦋

go read these next bestie, they're all part of the same friend group:

• ck_rhs_init(3)
• ck_rhs_move(3)
• ck_rhs_destroy(3)
• ck_rhs_fas(3)
• CK_RHS_HASH(3)
• ck_rhs_iterator_init(3)
• ck_rhs_next(3)
• ck_rhs_get(3)
• ck_rhs_put(3)
• ck_rhs_put_unique(3)
• ck_rhs_remove(3)
• ck_rhs_grow(3)
• ck_rhs_rebuild(3)
• ck_rhs_gc(3)
• ck_rhs_count(3)
• ck_rhs_reset(3)
• ck_rhs_reset_size(3)
• ck_rhs_stat(3)

additional info available at http://concurrencykit.org/ 🌐

and that's a wrap, babes 💅 this page is from September 1, 2014, and it's CK_RHS_APPLY(3) — slay, periodt ✨🎀💖