cgiFreeList(3)

cgiFreeList — frees memory used by a list 💖

okay bestie, welcome to cgiFreeList(3) from the Programmer's Manual, aka the little cleanup icon you call when you're done playing with a list. she's not glamorous, she's not complicated, she's just here to free stuff. and honestly? freeing stuff is the main character move. 🫶

---

✨ NAME ✨

cgiFreeList — frees the memory used by a list. that's it. that's the whole job. no cap. 💅

---

✨ SYNOPSYS ✨

(yes the heading is spelled like that in the original, we don't gatekeep, we love her 🌸)

#include <cgi.h>

void cgiFreeList (char **list);

so you pull in <cgi.h> and then you've got this function, cgiFreeList, and it takes exactly one thing: list, which is a char **. that's a pointer to a pointer to a char, if you're keeping score. 🎀

---

✨ DESCRIPTION ✨

so here's the lore, bestie. the routines cgiGetVariables(3), cgiGetCookies(3), and cgiGetFiles(3) all hand you back a zero terminated list of characters. like, they give you a whole list, terminated by a zero, chef's kiss, iconic behavior. ✨

and then cgiFreeList is the one who cleans it up. this routine frees the memory allocated by those routines. so like — if you don't call her, that memory is just... sitting there. abandoned. not slaying. 😭

lowkey important: the memory you're freeing here is memory that was allocated by cgiGetVariables(3), cgiGetCookies(3) and cgiGetFiles(3). that's the whole point. she frees what they made. that's the vibe. 🦋

---

✨ AUTHOR ✨

this CGI library is written by Martin Schulze <joey@infodrom.org>. if you have additions or improvements, please get in touch with him. fr fr, he actually wants to hear from you. 💜

---

✨ SEE ALSO ✨

• cgiGetVariables(3)
• cgiGetFiles(3)
• cgiGetCookies(3)

go read those three, they're the ones making the lists that you're about to free. it's giving ✨ collaborative ✨. 🌈

---

and that's the whole page, babe. 💖 this one comes to you from the CGI Library, dated 6 April 2008 — yeah she's an elder but she still ate, and she's still out here freeing lists for you. mwah. 🎀👑🌸