skipFreeList(3)

✨ skipFreeList(3) ✨

okay bestie, gather round, because today we're talking about skipFreeList from the util/skiplist.h family of icons πŸ’… she lives in section 3 of the manual (the library-calls girlies) and her whole job is, and I cannot stress this enough, letting go πŸ¦‹


🌸 NAME 🌸

skipFreeList β€” free a skip list. that's it. that's the whole vibe. she frees, she slays, she goes home πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

#include <util/skiplist.h>

void skipFreeList(skipList list);

like yes, include the header first, obviously, we're not animals πŸ™ˆ


πŸ“ ARGUMENTS πŸ“

  • list β€” the list you want to free. that's the one. the list. free her. set her free πŸ•ŠοΈ

πŸ‘‘ DESCRIPTION πŸ‘‘

Release all resources used by <list> β€” and when I say all, I mean ALL β€” including every single key/value pair hanging out in there. no stragglers, no leftovers, no little orphaned keys crying in the corner 😭 she takes the whole thing down.

ngl this is the "burn it all down, we're done here" function and honestly? iconic.

MT-Level: Safe for unique <list>.

which lowkey means: you can call her from multiple threads, but only if each thread has its own unique <list>. don't be sharing one list across threads and then freeing it, bestie, that's not the move πŸ’€


🌈 RETURN VALUE 🌈

None.</purpose>

yeah she returns nothing. she just does the thing. no receipt, no note, just vibes and reclaimed memory ✨


πŸ’œ SEE ALSO πŸ’œ

(and yes, skipFreeList(3) is listed in her own SEE ALSO, which is giving main character energy honestly, she's her own reference 🫢 and skipNewList is just out here with no section number, we love a mysterious queen 🧚)


ClearSilver 🌟 12 July 2007 🌟 that's the source and the date, mwah, go free your lists responsibly, ily, bye πŸ’–πŸŽ€πŸ¦‹