cgi_cookie_set(3)

💖 cgi_cookie_set — like, the cgi_cookie_set(3) page 💖

okay bestie, welcome to the cgi_cookie_set corner of the cgi/cgi.h world ✨ this is the one that hands a browser a cookie and is like "here, hold this for me 🍪". she's a section 3 girlie, a real one, no cap. let's get into it 💅

🌸 NAME 🌸

cgi_cookie_set — set a browser Cookie 🍪✨

🎀 SYNOPSIS 🎀

#include <cgi/cgi.h>

NEOERR *cgi_cookie_set (CGI *cgi, const char *name, const char *value,
                        const char *path, const char *domain,
                        const char *time_str, int persistent, int secure);

she's giving "eight arguments and not a single one is optional to look at" 😭 iconic honestly

🦋 ARGUMENTS 🦋

• cgi — a CGI struct. the whole main character of the situation 🫶
• name — the name of the cookie 🍪
• value — the value you're setting that cookie to
• path — optional path for which the cookie is valid. default is /
• domain — optional domain for which the cookie is valid. you can use cgi_cookie_authority to figure out this domain. default is none, and the browser interprets "none" as the sending domain only 👀
• time_str — expiration time string, formatted like this:

HH:MM: SS GMT

only used if persistent. default is one year from the time of the call ⏳

• persistent — cookie will be stored by the browser between sessions 💾
• secure — cookie will only be sent over secure connections 🔒

🌈 DESCRIPTION 🌈

so cgi_cookie_set will issue a Set-Cookie header that should cause a browser to return a cookie when required 🍪✨ that's the whole vibe. she's the messenger.

⚠️ okay but listen — this function does no escaping of anything. you have to take care of that first, bestie. she is NOT going to sanitize your inputs for you, that's on you fr fr 🙈

and that's the tea ☕

💜 RETURN VALUE 💜

none. she returns nothing. she just does the thing and leaves 😌 periodt

⭐ SEE ALSO ⭐

the whole friend group 🫶 go read these too:

• cgi_debug_init(3)
• cgi_parse(3)
• cgi_destroy(3)
• cgi_js_escape(3)
• cgi_html_escape_strfunc(3)
• cgi_register_strfuncs(3)
• cgi_output(3)
• parse_rfc2388(3)
• cgi_url_validate(3)
• open_upload(3)
• cgi_cs_init(3)
• cgi_url_escape_more(3)
• cgi_html_strip_strfunc(3)
• cgi_neo_error(3)
• cgi_redirect(3)
• cgi_filehandle(3)
• cgi_register_parse_cb(3)
• cgi_url_escape(3)
• cgi_init(3)
• cgi_redirect_uri(3)
• cgi_cookie_clear(3)
• cgi_url_unescape(3)
• cgi_vredirect(3)
• cgi_display(3)
• cgi_html_ws_strip(3)
• cgi_error(3)
• cgi_cookie_set(3)
• cgi_text_html_strfunc(3)
• cgi_cookie_authority

and that's the page, bestie 💖✨ this one came to you from ClearSilver, dated 12 July 2007 🎀 a lil vintage, a lil iconic, we love her. stay safe out there and remember to escape your cookie values before you set them, ok bye 👑💅🦋