kw_filter_metadata()

`kw_filter_metadata()`#

The function kw_filter_metadata() returns a duplicate of the given JSON object or array, removing all metadata keys that begin with ‘__’.

C

Prototype

json_t *kw_filter_metadata(
    hgobj gobj,
    json_t *kw  // owned
);

Parameters

Key	Type	Description
`gobj`	`hgobj`	A handle to the GObj system, used for logging errors.
`kw`	`json_t *`	The JSON object or array to be filtered. This parameter is owned and will be decremented.

Return Value

A new JSON object or array with all metadata keys removed. The caller owns the returned JSON object.

Notes

Metadata keys are identified as those beginning with ‘__’. If kw is not an object or array, an error is logged, and NULL is returned.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python