cgiGetValue(3)

💖 cgiGetValue 💖

okay bestie, welcome to the manual page for cgiGetValue, living in the Programmer's Manual section 3, aka the place where we talk about library functions. this one is about grabbing the deets on a CGI file variable. yes it's named cgiGetValue and the NAME bit below says cgiGetFile. the manual said it, not me, and I refuse to edit the queen. 💅

---

✨ NAME ✨

cgiGetFile — Return information of a CGI file variable 🎀

---

🦋 SYNOPSYS 🦋

(yes bestie, that's the spelling on the page. we don't fix her. we love her. 💀)

#include <cgi.h>

s_file *cgiGetFile (s_cgi *parms, const char *name);

---

🌸 DESCRIPTION 🌸

so like. this routine hands you back a pointer to a data structure that's all tied up with the value of a CGI file variable. and listen — that pointer must NOT be freed. not by you. not by your code. hands off. 🙈

the s_file structure is declared like this, exactly like this:

typedef struct file_s {
    char   *name,
           *type,
           *filename,
           *tmpfile;
} s_file;

and the memory that this data structure eats up? it gets automatically freed by that final call to cgiFree(3). so you literally don't have to worry about it, the library has main character energy and handles it for you. ✨

---

👑 RETURN VALUE 👑

on success, you get a pointer to the s_file datastructure. slay. 💖

but if the variable wasn't transmitted, or if it wasn't transmitted through CGI, or if the filename was empty — then you get NULL. that's the vibe check and it did not pass. 😭

---

💜 AUTHOR 💜

this CGI library is written by Martin Schulze <joey@infodrom.org>. and fr fr, if you've got additions or improvements, please get in touch with him — he wants to hear from you, bestie. 🫶

---

🌈 SEE ALSO 🌈

• cgiGetFiles(3)
• cgiGetVariables(3)
• cgiGetCookies(3)
• cgiDebug(3)
• cgiInit(3)
• cgiFree(3)

---

and that's the whole page, no notes. this was the CGI Library version, dated 6 April 2008, filed under cgiGetValue(3). go free your pointers, or actually — don't free that one. 💅✨🎀