cgi_redirect_uri(3)

💖 cgi_redirect_uri(3) 💖

okay bestie, welcome to the cgi_redirect_uri page from the cgi/cgi.h manual — yes it's a section 3 page, yes it's part of ClearSilver, and yes we're about to make redirecting people around your site look effortless. 🦋

✨ NAME ✨

cgi_redirect_uri — send an HTTP 302 redirect response 💅

like. that's the whole job. send the 302. move the person. slay.

🎀 SYNOPSIS 🎀

#include <cgi/cgi.h>

void cgi_redirect_uri (CGI *cgi, const char *fmt, ...)
                       ATTRIBUTE_PRINTF(2,3);

🌸 ARGUMENTS 🌸

• cgi — the cgi struct, obviously, your whole main character of a context object 🫶
• fmt — a printf style format, plus args, because variety is the spice of life ✨

🌈 DESCRIPTION 🌈

okay so cgi_redirect_uri will redirect the user to another page on your site. simple as that, no notes. 🧚

the way this version works is that it takes the full URL — and I mean the whole thing: protocol, domain, port, path. all of it. not just the little path bit. the entire URL. periodt. 👑

and listen, bestie, this is the important part: as with all printf style commands, you should not call this with arbitrary input that may contain % characters 😭. if you're forwarding something directly, use a format like this instead:

cgi_redirect (cgi, "%s", buf)

that's it. that's the safety move. do it. 💖

⭐ RETURN VALUE ⭐

None. nada. nothing. it returns void, she simply does not return a value, and honestly? iconic behaviour. 💀✨

🦋 SEE ALSO 🦋

go read these too, they're all part of the same little friend group:

• 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!! 🎀 this one came to you courtesy of ClearSilver, dated 12 July 2007 — yeah she's a lil vintage but she still ate, and she's still serving 302s like it's nothing. bye bestie, go redirect responsibly 💖✨🦋