kw_set_dict_value()

The function kw_set_dict_value() sets a value in a JSON dictionary at the specified path. If intermediate objects do not exist, they are created as dictionaries. Arrays are not created automatically.

C

Prototype

int kw_set_dict_value(
    hgobj      gobj,
    json_t    *kw,
    const char *path,   // The last word after delimiter (.) is the key
    json_t    *value    // owned
);

Parameters

Key	Type	Description
gobj	hgobj	A handle to the GObj context, used for logging and error handling.
kw	json_t *	A JSON dictionary where the value will be set. Must be a valid JSON object.
path	const char *	A dot-delimited path specifying where to set the value. The last segment is the key.
value	json_t *	The JSON value to set at the specified path. Ownership is transferred.

---

Return Value

Returns 0 on success, or -1 if an error occurs (e.g., if kw is not a dictionary).

Notes

If the path does not exist, intermediate objects are created as dictionaries. Arrays are not created automatically. The function uses kw_find_path() internally to navigate the JSON structure.

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