tranger2_open_topic()

The tranger2_open_topic() function opens a topic in the TimeRanger database. If the topic is already open, it returns the existing topic JSON object.

C

Prototype

json_t *tranger2_open_topic(
    json_t  *tranger,
    const char  *topic_name,
    BOOL  verbose
);

Parameters

Key	Type	Description
tranger	json_t *	A JSON object representing the TimeRanger database.
topic_name	const char *	The name of the topic to open.
verbose	BOOL	If TRUE, additional debug information is printed.

---

Return Value

A JSON object representing the opened topic. The returned object is not owned by the caller and should not be modified or freed.

Notes

This function is idempotent, meaning that calling it multiple times with the same topic_name will return the same JSON object without creating a new instance.

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