treedb_get_node()

Retrieves a node from the TreeDB using its primary key. The function returns a reference to the node stored in the database, which must not be modified directly.

C

Prototype

json_t *treedb_get_node(
    json_t       *tranger,
    const char   *treedb_name,
    const char   *topic_name,
    const char   *id
);

Parameters

Key	Type	Description
tranger	json_t *	A reference to the TimeRanger database instance.
treedb_name	const char *	The name of the TreeDB from which to retrieve the node.
topic_name	const char *	The topic within the TreeDB that contains the node.
id	const char *	The primary key of the node to retrieve.

---

Return Value

A reference to the requested node as a json_t *. The returned node must not be modified directly.

Notes

The returned node is not owned by the caller and should not be modified or freed. Use treedb_update_node() to modify the node safely.

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