cgiGetVariables(3)

💖 cgiGetVariables(3) — bestie edition 💖

okay so this is a page from the Programmer's Manual, and it's about cgiGetVariables, a lil function from the CGI Library. sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

cgiGetVariables — returns a list of CGI variables. that's it. that's the whole job. iconic behaviour honestly 👑

---

🌸 SYNOPSYS 🌸

#include <cgi.h>

char **cgiGetVariables (s_cgi *parms);

like. look at it. one function, one argument, zero drama. we love a low-maintenance queen 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea, bestie. this routine returns a NULL terminated array of the CGI variables that are available. just the names of what's there, okay? it's giving guest list energy — it tells you who showed up, not what they're wearing.

so if you actually wanna know the value of one of those variables, you're gonna have to go use cgiGetValue(3). that's a whole separate function, we don't do that here. no cap.

and when you're done with the array — and you WILL be done with it — free that memory with cgiFreeList(3). do not skip this step. memory leaks are not the vibe. 🙈

---

💜 RETURN VALUE 💜

• success era — you get a NULL terminated array of strings returned to you. the very last element is set to NULL, so you know exactly where the party ends. periodt.
• not so slay — if an error occurred, or if there are literally no variables available, you get NULL back. no array, no list, nothing. just NULL. 😭

heads up bestie: NULL can mean error OR nothing available — same return, two different moods. check your setup either way.

---

👑 AUTHOR 👑

this CGI library is written by Martin Schulze <joey@infodrom.org>. and like, if you have additions or improvements, please get in touch with him! he literally said so. he wants to hear from you fr fr 🫶

---

🌈 SEE ALSO 🌈

the whole friend group, go say hi:

• cgiGetValue(3)
• cgiGetCookie(3)
• cgiGetCookies(3)
• cgiFreeList(3)
• cgiDebug(3)
• cgiHeader(3)
• cgiInit(3)

---

and that's the page!! mwah 💋 this was the CGI Library, dated 6 April 2008 — yeah she's an elder but she still ate. byeee, go free your lists 💖✨🎀