KHTML_NCR(3)

💅 KHTML_NCR(3) 💅

okay so bestie, welcome to KHTML_NCR(3) from the Library Functions Manual — yes, the whole group chat is here and we are keeping every single detail ✨.

---

🌸 NAME 🌸

khtml_ncr — put character entity content for kcgihtml 💖.

🎀 LIBRARY 🎀

the whole thing lives in library “libkcgihtml” 🫶.

✨ SYNOPSIS ✨

here is the exact include lineup and the function signature, no cap:

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

enum kcgi_err
khttp_ncr(struct kreq *req, uint32_t v);

copy that exactly as written, bestie — no renaming, no fixing, no editing the source vibes 💅.

🦋 DESCRIPTION 🦋

okay so what does it actually do? It writes a character entity v to a context req initialised with khtml_open(3) 💖. The value is formatted as "&#xNNNN;" — literally that shape — and ngl, it is not checked for being a valid entity number 🙈. So do not expect a vibe check on your entity number, because it does not get one.

🔥 RETURN VALUES 🔥

Returns an enum kcgi_err indicating the error state. Here is the whole cast, no skips:

• KCGI_OK — Success (not an error) ✨ — we love a non-error.
• 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 parse loop reentered. handle it, bestie.
• 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 💀.

🌈 EXAMPLES 🌈

The following outputs a simple HTML page. 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_TEXT_HTML]);
             khttp_body(r);
             khtml_open(&req, r, 0);
             khtml_elem(&req, KELEM_DOCTYPE);
             khtml_elem(&req, KELEM_HTML);
             khtml_elem(&req, KELEM_BODY);
             khtml_elem(&req, KELEM_P);
             khtml_ncr(&req, 0x1F601); /* smiley */
             khtml_close(&req);

the /* smiley */ comment is right there and honestly iconic 😊.

🧚 SEE ALSO 🧚

kcgihtml(3) — that is the one, bestie, go peek 👀.

💜 STANDARDS 💜

The referenced HTML5 standard is HTML5.2: https://www.w3.org/TR/html52 ✨.

👑 AUTHORS 👑

Written by Kristaps Dzonsons <kristaps@bsd.lv> — author icon behavior 👑.

🍓 that is the page, bestie — Debian source/version with the $Mdocdate$ date stamp, filed under KHTML_NCR(3) 💖.