KJSON_CLOSE(3)

💖 KJSON_CLOSE(3) — like, the manual page, bestie 💖

okay so this is a page from the Library Functions Manual (the KJSON_CLOSE(3) corner of it), and we're gonna get you fluent in it, no cap ✨

---

🌸 NAME 🌸

kjson_close — closes the kcgijson context, that's the whole vibe 🎀

---

🦋 LIBRARY 🦋

library “libkcgijson” — that's where this lil function lives, iykyk 💅

---

✨ SYNOPSIS ✨

like, include these first or nothing works, periodt:

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

enum kcgi_err
kjson_close(struct kjsonreq *req);

---

💜 DESCRIPTION 💜

So kjson_close closes req, which you opened with kjson_open(3) — yes, they're a matching set, iconic behavior 🫶

And here's the slay part: every single scope you opened with kjson_obj_open(3), kjson_objp_open(3), kjson_array_open(3), kjson_arrayp_open(3), kjson_string_open(3), and kjson_stringp_open(3) gets closed automatically for you. Not me doing all the cleanup 💅✨

🚨 bestie, listen: after this, req may no longer be used. Like, it's done. It's retired. Do not touch it again, fr fr 😭

---

🔥 RETURN VALUES 🔥

It returns an enum kcgi_err telling you the error state — vibe check time:

• KCGI_OK — Success. Not an error. We love a happy ending 🌈
• KCGI_ENOMEM — Internal memory allocation failure 😭 the memory said no
• 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 means khttp_body(3) didn't return with success, or it was never invoked 🙈 For FastCGI connections, the current connection should be released with khttp_free(3) and the parse loop reentered.
• KCGI_SYSTEM — Internal system error while writing to the output stream. Rough 🥲

---

🎀 EXAMPLES 🎀

Here's a whole little JSON page being served — look at her go 👑

It assumes r is a struct kreq pointer. And for brevity (we're being efficient besties), it does not do any error checking 😌

khttp_head(r, kresps[KRESP_STATUS],
  "%s", khttps[KHTTP_200]);
khttp_head(r, kresps[KRESP_CONTENT_TYPE],
  "%s", kmimetypes[KMIME_APP_JSON]);
khttp_body(r);
kjson_open(&req, r);
kjson_obj_open(&req);
kjson_putstringp(&req, "foo", "bar");
kjson_close(&req);

---

⭐ SEE ALSO ⭐

• kcgijson(3) — go read that one next, it's the main character 🧚

---

👑 AUTHORS 👑

Written by Kristaps Dzonsons <kristaps@bsd.lv>. Respect the icon who wrote it 💖

---

aaaand that's the page! it's from Debian, version $Mdocdate$, and it goes by KJSON_CLOSE(3) — mwah, go close some contexts responsibly, bestie 💋🦋🍓