dictModifyValue(3)

💖 dictModifyValue(3) 💖

okay bestie, so this one lives in util/dict.h and it's the glow-up function — it either makes a whole new value or tweaks the one that's already there. main character energy fr fr. ✨

🌸 NAME 🌸

dictModifyValue — create/modify an item.

🎀 SYNOPSIS 🎀

#include <util/dict.h>

NEOERR *dictModifyValue(dictCtx dict, const char *id, dictNewValueCB new_cb,
                     dictUpdateValueCB update, void *rock);

🦋 ARGUMENTS 🦋

• dict — the dictionary we're adding the pair to, periodt.
• id — the identifier of the value. like, its name tag 🏷️
• new — the function you call to create a brand new value (it's allowed to be NULL, no pressure).
• update — the function you call to modify a value. heads up: if this is NULL, the old value gets freed, and <new> is used instead. so yeah, choices were made 💅
• rock — the context you pass along to <new> or <update>. carry it with you like a little emotional support rock 🪨🫶

🌈 DESCRIPTION 🌈

So here's the tea: it finds <id>'s value and calls <update> on it. Simple. But if <id> isn't in <dict> at all? Then it calls <new> to go get a fresh new value. iconic behaviour, honestly. 💖

MT-Level: Safe if <dict> is thread-safe.

⭐ RETURN VALUE ⭐

None. nothing. void. the silence is the answer 😭

👑 SEE ALSO 👑

dictDestroy(3), dictCleanup(3), dictReleaseLock(3), dictRemove(3), dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3), dictSearch

and that's the whole page, bestie!! this one's brought to you by ClearSilver, dated 12 July 2007 — yeah it's vintage, it's giving classic, we love her anyway 🎀✨💜