gobj_match_childs_tree()

gobj_match_childs_tree()#

Returns an iterator (JSON list of hgobj) containing all matched child objects, including deep levels of children. It traverses the entire tree of child objects and applies the given filter.

Prototype

json_t *gobj_match_childs_tree(
    hgobj gobj,
    json_t *jn_filter   // owned
);

Parameters

Key

Type

Description

gobj

hgobj

The parent object whose child tree will be searched.

jn_filter

json_t *

A JSON object containing filter criteria. Only child objects matching this filter will be included in the result.


Return Value

A JSON array containing matched child objects. The returned list must be freed using gobj_free_iter().

Notes

This function performs a deep search, checking all levels of child objects. The filter is applied recursively to all descendants.

Prototype

// Not applicable in JS

Prototype

# Not applicable in Python
Examples
// TODO C examples
// TODO JS examples
# TODO Python examples