JSON Builder API

The JSON Builder provides a lightweight way to construct JSON strings without the overhead of a full DOM parser.

Functions

cwist_json_builder_create

cwist_json_builder *cwist_json_builder_create(void);

cwist_json_begin_object / cwist_json_end_object

Starts and ends a JSON object { ... }.

cwist_json_add_string

Adds a key-value pair where the value is a string.

void cwist_json_add_string(cwist_json_builder *b, const char *key, const char *value);

cwist_json_add_int

Adds a key-value pair where the value is an integer.

void cwist_json_add_int(cwist_json_builder *b, const char *key, int value);

cwist_json_add_bool

Adds a key-value pair where the value is a boolean.

void cwist_json_add_bool(cwist_json_builder *b, const char *key, bool value);

cwist_json_add_null

Adds a key-value pair where the value is null.

void cwist_json_add_null(cwist_json_builder *b, const char *key);

cwist_json_begin_array / cwist_json_end_array

Starts and ends a JSON array [ ... ]. If key is provided, it's added as "key": [.

void cwist_json_begin_array(cwist_json_builder *b, const char *key);
void cwist_json_end_array(cwist_json_builder *b);

cwist_json_get_raw

Returns the constructed JSON string as a const char *.

const char *cwist_json_get_raw(cwist_json_builder *b);

• Ownership: The string is owned by the builder and remains valid until the builder is destroyed. Do NOT free this pointer.

cwist_json_builder_destroy

void cwist_json_builder_destroy(cwist_json_builder *b);

Frees all memory owned by the builder, including the internal buffer returned by cwist_json_get_raw. Must be called once when the builder is no longer needed.

Example

cwist_json_builder *jb = cwist_json_builder_create();
cwist_json_begin_object(jb);
cwist_json_add_string(jb, "status", "success");
cwist_json_add_int(jb, "code", 200);
cwist_json_end_object(jb);
 
printf("%s\n", cwist_json_get_raw(jb));
 
cwist_json_builder_destroy(jb);