KJSON_STRING_CLOSE(3)

✨ kjson_string_close — open string scope for kcgijson ✨

okay so welcome to the KJSON_STRING_CLOSE(3) page in the Library Functions Manual — yes bestie, we are deep in Unix docs and this one is a lil’ string-scope closer. It’s giving “finish the string, queen.” 💅

---

💖 NAME 💖

kjson_string_close — open string scope for kcgijson

🎀 LIBRARY 🎀

library “libkcgijson”

🦋 SYNOPSIS 🦋

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

enum kcgi_err
kjson_string_close(struct kjsonreq *req);

🌸 DESCRIPTION 🌸

kjson_string_close closes an string scope that was created with kjson_string_open(3) or kjson_stringp_open(3), inside a context req that was initialised with khtml_open(3).

Closing a non-string scope is an error — do not do it, fr fr. 💀

🔥 RETURN VALUES 🔥

It returns an enum kcgi_err that tells you the error state, iykyk.

• KCGI_OK — Success (not an error).
• 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 parse loop reentered.
• KCGI_FORM — The connection is still expecting headers with khttp_head(3). 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 parse loop reentered.
• KCGI_SYSTEM — Internal system error writing to the output stream.
• KCGI_WRITER — The current scope is not a string.

💀 EXAMPLES 💀

The following outputs a simple JSON document. It assumes r is a struct kreq pointer. For brevity, 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_string_open(&req);
kjson_string_puts(&req, "Hello, ");
kjson_string_puts(&req, "world.");
kjson_string_close(&req);
kjson_close(&req);

🫶 SEE ALSO 🫶

kcgijson(3)

👑 AUTHORS 👑

Written by Kristaps Dzonsons <kristaps@bsd.lv>.

---

and that’s the whole page, bestie 🫶 this cutie comes from the Debian edition, dated $Mdocdate$, and it’s filed under KJSON_STRING_CLOSE(3). slay. 💖