cgiGetCookie(3)

💖 cgiGetCookie(3) — Programmer's Manual energy, but make it cute 💖

okay bestie, so you want a cookie?? 🍪 not the snickerdoodle kind, the web kind. this page is from the Programmer's Manual and it's literally all about cgiGetCookie from the CGI Library. let's get into it 💅

---

✨ NAME ✨

cgiGetCookie — Return a cookie 🍪

---

🌸 SYNOPSYS 🌸

(it's spelled like that in the original, don't come for me, i just work here 🫶)

#include <cgi.h>

s_cookie *cgiGetCookie (s_cgi *parms, const char *name);

---

🦋 DESCRIPTION 🦋

so this routine hands you back a pointer to a s_cookie structure that's holding all the values for the cookie that name points at. and listen — the pointer must not be freed. like, do NOT free it. not your job, not your moment, hands off 🙈

the s_cookie structure is declared like this, iconic little thing:

typedef struct cookie_s {
    char     *version,
             *name,
             *value,
             *path,
             *domain;
} s_cookie;

all the memory that this data structure grabs? it gets automatically freed by the final call to cgiFree(3). so the library handles the cleanup, you just vibe ✨

now, if you want to set a cookie in your program, you're gonna have to manually add extra header lines yourself. no shortcuts, bestie. go peek at cgitest.c for the full picture. basically you need to add this code:

cgiSetHeader ("Set-Cookie", "Version=1; name=value; Path=/");
cgiHeader();

also please please PLEASE read the included file cookies.txt as well. it's important, i don't make the rules 🌈

---

⭐ RETURN VALUE ⭐

on success, you get a pointer to a s_cookie structure. slay. 👑

if no cookie was set, or there's just no cookie with that given name? you get NULL. that's it. that's the vibe check. 💀

---

👑 AUTHOR 👑

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

---

🔥 SEE ALSO 🔥

• cgiGetValue(3)
• cgiGetVariables(3)
• cgiGetCookies(3)
• cgiDebug(3)
• cgiHeader(3)
• cgiInit(3)
• cgiFree(3)

---

and that's the whole page, no cap 🎀 this was CGI Library, dated 6 April 2008 — so like, vintage, but make it serve 💜 bye bestie, go get your cookies!! 🍓🧚✨