FreeBSD Manual Pages
KCGIJSON(3) Library Functions Manual KCGIJSON(3) NAME kcgijson -- JSON output for kcgi LIBRARY library "libkcgijson" SYNOPSIS #include <sys/types.h> #include <stdarg.h> #include <stdint.h> #include <kcgi.h> #include <kcgijson.h> DESCRIPTION Produce output of JSON objects and arrays in a kcgi(3) context allo- cated with khttp_parse(3). To compile and link, use pkg-config(1) as follows: % cc `pkg-config --cflags kcgi-json` -c sample.c % cc -o sample sample.o `pkg-config --libs kcgi-json` All kcgijson functions accept a struct kjsonreq object. To use this properly, open a context with kjson_open(3), add content, then end with kjson_close(3). EXAMPLES Let struct kreq *r already be initialised, and the request be for KMIME_APP_JSON. The following fragment prints out a simple JSON ob- ject. Error checking is omitted for brevity. kjson_open(&req, r); kcgi_writer_disable(r); 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_objp_open(&req, "anobj"); kjson_putstringp(&req, "astring", "baz"); kjson_putintp(&req, "anint", 12345); kjson_stringp_open(&req, "alongstring"); kjson_string_puts(&req, "hello, "); kjson_string_puts(&req, "world."); kjson_string_close(&req); /* alongstring */ kjson_arrayp_open(&req, "anarray"); kjson_putint(&req, 1); kjson_putint(&req, 2); kjson_putdouble(&req, 3.0); kjson_array_close(&req); /* anarray */ kjson_obj_close(&req); /* anobj */ kjson_close(&req); Following the kcgi_writer_disable(3) call, no further writers may be allocated. SEE ALSO kjson_array_close(3), kjson_array_open(3), kjson_close(3), kjson_obj_close(3), kjson_obj_open(3), kjson_open(3), kjson_putbool(3), kjson_putdouble(3), kjson_putint(3), kjson_putnull(3), kjson_putstring(3), kjson_string_close(3), kjson_string_open(3), kjson_string_write(3) STANDARDS The kcgijson functions conform to the ECMA-404 JSON Data Interchange Standard, also documented as RFC 7159. Parts of this document refer- ence ECMAScript 5, commonly known as JavaScript. AUTHORS Written by Kristaps Dzonsons <kristaps@bsd.lv>. FreeBSD Ports 14.quarterly $Mdocdate$ KCGIJSON(3)
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | STANDARDS | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=kcgijson&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>