cgiwrap_iterenv(3)

💖 cgiwrap_iterenv(3) 💖

okay bestie, welcome to cgiwrap_iterenv, straight outta the <cgi/cgiwrap.h> header in the ClearSilver cgi family. she's a little iterator, she's lowkey the backbone of your debug output, and she's about to hand you every single environment variable one at a time like a girl passing out friendship bracelets. 🎀

✨ NAME ✨

cgiwrap_iterenv — iterater for env vars 🌸

yes, the manpage literally says "iterater". we don't fix it. we love her exactly as she is. no cap. 💅

✨ SYNOPSIS ✨

#include <cgi/cgiwrap.h>

NEOERR *cgiwrap_iterenv (int n, char **k, char **v);

like, that's the whole vibe. one include, one call, infinite env-var lore. 🦋

✨ ARGUMENTS ✨

• n — the variable you wanna return. start it at 0 and keep incrementing until you get a NULL return value back. that's your little "we're done here" signal, periodt. ⭐

✨ DESCRIPTION ✨

so here's the tea: cgiwrap_iterenv lets a program iterate over all the environment variables. every single one. one by one. no skipping. 💖

it's probably mostly used by the default debug output — iykyk. 👑

✨ RETURN VALUE ✨

• k — a malloc'd copy of the variable name 🎀
• v — a malloc'd copy of the variable value 🎀

bestie. listen. those are malloc'd copies. that memory is yours now. you gotta free it. not me forgetting to free and leaking like a broken heart. 😭

✨ SEE ALSO ✨

the whole friend group, fr fr:

• cgiwrap_iterenv(3)
• cgiwrap_putenv(3)
• cgiwrap_init_emu(3)
• cgiwrap_writef(3)
• cgiwrap_init_std(3)
• cgiwrap_writevf(3)
• cgiwrap_read(3)
• cgiwrap_write(3)
• cgiwrap_getenv

and that's the whole page, bestie!! this iconic little number comes to you from ClearSilver, dated 12 July 2007 — yes she's vintage, yes she still ate, and yes she's still serving env vars to this very day. 🫶 go iterate, go free your mallocs, and go be the main character of your own cgi script. mwah. 💜🌸✨