kw_collapse()

kw_collapse() returns a new JSON object where arrays or dictionaries exceeding specified size limits are collapsed into a placeholder structure indicating their path and size.

C

Prototype

json_t *kw_collapse(
    hgobj gobj,
    json_t *kw,         // not owned
    int collapse_lists_limit,
    int collapse_dicts_limit
);

Parameters

Key	Type	Description
gobj	hgobj	A handle to the calling object, used for logging and error reporting.
kw	json_t *	The JSON object to be processed. Must be a dictionary.
collapse_lists_limit	int	The maximum allowed size for lists before they are collapsed.
collapse_dicts_limit	int	The maximum allowed size for dictionaries before they are collapsed.

---

Return Value

A new JSON object with large lists and dictionaries collapsed. Returns NULL if kw is not a dictionary.

Notes

Collapsed elements are replaced with a structure containing __collapsed__ metadata, including their path and size.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

Examples

C

// TODO C examples

JS

// TODO JS examples

Python

# TODO Python examples