dictSearch(3)

💖 dictSearch(3) 💖

okay so bestie, welcome to dictSearch(3) — the little function from util/dict.h that goes hunting through a dictionary for your fave value and hands it back to you. it's giving "personal shopper but for data" ✨ let's get into it.

🌸 NAME 🌸

dictSearch — search for value in dictionary. no cap, that's the whole job description. 💅

✨ SYNOPSIS ✨

#include <util/dict.h>

void *dictSearch(dictCtx dict, const char *id, void **plock);

like… three args, one pointer back, and a whole lot of main character energy. 🫶

🎀 ARGUMENTS 🎀

• dict — the dictionary you're searching in. your search zone. your kingdom. 👑
• id — the identifier of the item you wanna find. it's literally the name tag at the party. 🏷️
• plock — place for the value lock (or NULL if you're not about that lock life). 🙈

🦋 DESCRIPTION 🦋

so what it does: it searches for <id> in <dict>, and returns the value if it found it, or NULL if it didn't. that's it, that's the vibe. 🔍

and here's the spicy part — if <plock> is non-NULL, then the lock returned in <plock> will be associated with the returned value. the way that works: until this lock is passed to dictReleaseLock(), the value will not be passed to the dictCleanupFunc callback (see dictCleanup()). so like, hold onto that lock and you're basically protecting your fave from getting swept up. 💖

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

⭐ RETURN VALUE ⭐

• plock — set to the value lock. yeah bestie, it writes back into your pointer. 😭

🌈 SEE ALSO 🌈

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

like a whole friend group fr fr, go say hi. 🫶✨

ClearSilver · 12 July 2007 — yeah this page has been iconic since way back, and it's still serving. stay hydrated, lock your values, and go search something. 💅🎀🦋