cgiwrap_read(3)

💖 cgiwrap_read — cgiwrap input function 💖

okay bestie, welcome to the cgi/cgiwrap.h section of the manual, page cgiwrap_read(3), and yes you're gonna be obsessed. this one's short and sweet, like a little strawberry 🍓 of a function. let's get into it.

✨ NAME ✨

cgiwrap_read — the cgiwrap input function. it reads stuff in. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <cgi/cgiwrap.h>

void cgiwrap_read (char *buf, int buf_len, int *read_len);

look at that. three args. no cap. 🎀

🦋 ARGUMENTS 🦋

• buf — a pre-allocated buffer that you're reading the data into. you gotta bring your own buffer, bestie, this function is not about to make one for you. 🙈
• buf_len — the size of that pre-allocated buffer. it needs to know how much room it's working with, obviously. ✨

not me noticing read_len isn't in the ARGUMENTS list… it's down in RETURN VALUE, iykyk, keep reading 👑

💜 DESCRIPTION 💜

so cgiwrap_read is what you use to read incoming data from the client — usually the stuff coming in from a POST or a PUT HTTP request. 🌈

it wraps the part of fread(stdin). literally that's it. it's giving "glorified fread but make it cgiwrap" and honestly? iconic. 👑

⭐ RETURN VALUE ⭐

• read_len — the number of bytes read into buf. so after it runs, that pointer is holding how much actually landed in your buffer. 💖

🔥 SEE ALSO 🔥

go read these too, bestie, they're all in the same friend group:

• 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 page!! 💜 this was brought to you by the ClearSilver era, dated 12 July 2007 — yeah she's a vintage queen 👑 and she still slays. mwah, go read your stdin responsibly, ily, bye 🫶✨