tranger2_topic()

`tranger2_topic()`#

Retrieve a topic by its name from the TimeRanger database. If the topic is not already opened, tranger2_open_topic() is called to open it.

C

Prototype

json_t *tranger2_topic(
    json_t      *tranger,
    const char  *topic_name
);

Parameters

Key	Type	Description
`tranger`	`json_t *`	Pointer to the TimeRanger database instance.
`topic_name`	`const char *`	Name of the topic to retrieve.

Return Value

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

Notes

If the topic exists on disk but has not been opened yet, tranger2_open_topic() is automatically invoked.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python