KCGI_BUF_PUTS(3)

💅 KCGI_BUF_PUTS(3) — it's giving "library functions manual" ✨

okay so bestie, welcome to the manual page for kcgi_buf_puts — a function from the libkcgi library (that's "library "libkcgi"" to be formal about it 🎀). this one's short, sweet, and honestly kind of iconic. let's get into it 💖

---

🌸 NAME 🌸

kcgi_buf_puts — put string content into a kcgi buffer 🫶

---

📚 LIBRARY 📚

the library is literally libkcgi, no cap ✨

---

🦋 SYNOPSIS 🦋

#include <sys/types.h>
#include <stdarg.h>
#include <stdint.h>
#include <kcgi.h>

enum kcgi_err
kcgi_buf_puts(struct kcgi_buf *buf, const char *cp);

---

💜 DESCRIPTION 💜

okay so what it does: it appends a NUL-terminated string cp to a buffer buf. that's the whole vibe, honestly 🌈

⭐ IMPORTANT, bestie: buffers must be initialised to zero with memset(3) prior to first use. like, before you touch them. no exceptions, periodt 💅

the way this function handles things: it does nothing if cp is NULL (silent queen behavior, she just moves on 🙈).

and heads up — it does not append a newline like puts(3) does. so don't come crying to me when your output is all crammed on one line, iykyk 😭

---

🔥 RETURN VALUES 🔥

it returns an enum kcgi_err indicating the error state. here's the full lineup 👑

• KCGI_OK — success, we love to see it 💖 (not an error, bestie, she's fine)
• KCGI_ENOMEM — internal memory allocation failure 😭
• KCGI_HUP — the output connection has been terminated 💀. for FastCGI connections, the current connection should be released with khttp_free(3) and the parse loop reentered 🔁
• KCGI_FORM — the connection is still expecting headers with khttp_head(3) 🫠. this indicates that khttp_body(3) did not return with success or was not invoked. for FastCGI connections, the current connection should be released with khttp_free(3) and the parse loop reentered 🔁
• KCGI_SYSTEM — internal system error writing to the output stream 🚨

---

✨ EXAMPLES ✨

okay here's a cute little example 🎀 — it creates a simple NUL-terminated buffer and outputs its contents. note: it does not perform any error checking, so this is very "living in the moment" of it ngl 🙈

struct kcgi_buf buf;

memset(&buf, 0, sizeof(struct kcgi_buf));
kcgi_buf_puts(&buf, "Hello, world!");
puts(buf.buf); /* Emits "Hello, world!" */
free(buf.buf);

and yes, she emits "Hello, world!" — iconic behavior, honestly 🌍💫

---

👀 SEE ALSO 👀

• kcgi_buf_printf(3)
• kcgi_buf_putc(3)
• kcgi_buf_write(3)

go read those next, bestie, they're all part of the same friend group 🫶

---

🌟 AUTHORS 🌟

written by Kristaps Dzonsons <kristaps@bsd.lv> 👑 — thank you for your service, king 🫡

---

and that's the page!! 💖 this version came from Debian, dated $Mdocdate$, and it's the KCGI_BUF_PUTS(3) manual page — mwah, slay, bye bestie 💅✨🎀