skipNext(3)

✨ NAME ✨

skipNext — bestie, this is the "find the next item" girlie 💅

🦋 SYNOPSIS 🦋

#include <util/skiplist.h>

void *skipNext(skipList list, UINT32 *pkey, void **plock);

🌸 ARGUMENTS 🌸

• list — the list you're searching in, duh 🙈
• pkey — a pointer to the previous key (pass 0 to start from the very beginning, main character energy 👑)
• plock — where the value lock goes (or NULL, if you're not about that lock life)

💖 DESCRIPTION 💖

Okay so here's the tea ☕ — skipNext goes searching in the list <list> for the item whose key is the next larger one than whatever's sitting in <pkey>, and it hands you back that item's value if it found one, or NULL if it didn't. No cap, that's it. ✨

And if <plock> is non-NULL? Then the lock it gives you back in <plock> is gonna be associated with the value it returned, periodt. And here's the important part, bestie — until you pass that lock over to skipRelease(), the value will NOT be freed by the freeValue callback (peep skipNewList() for the deets). So like, hold onto that lock responsibly 🫶

MT-Level: Safe if <list> is thread-safe. That's the whole vibe check. 🔥

⭐ RETURN VALUE ⭐

• pkey — gets set to the new key 🎀
• plock — gets set to the value lock 🔐

🌈 SEE ALSO 🌈

skipDelete(3), skipFreeList(3), skipRelease(3), skipInsert(3), skipSearch(3), skipNext(3), skipNewList

and that's the whole page, bestie!! this one's brought to you by ClearSilver 💜 and it's dated 12 July 2007 — iconic, vintage, timeless. mwah 💋