tranger2_close_all_lists()

tranger2_close_all_lists()#

Closes all iterators, disk lists, or memory lists associated with a given creator in the specified topic_name. If rt_id is provided, only lists matching the rt_id are closed.

Prototype

int tranger2_close_all_lists(
    json_t *tranger,
    const char *topic_name,
    const char *rt_id,      // if empty, remove all lists of creator
    const char *creator     // if empty, remove all
);

Parameters

Key

Type

Description

tranger

json_t *

Pointer to the TimeRanger database instance.

topic_name

const char *

Name of the topic whose lists should be closed.

rt_id

const char *

Realtime list identifier. If empty, all lists of the creator are removed.

creator

const char *

Creator identifier. If empty, all lists are removed.


Return Value

Returns 0 on success, or a negative value on failure.

Notes

This function ensures that all iterators and lists associated with a specific creator are properly closed, preventing resource leaks. If both rt_id and creator are empty, all lists in the topic_name are closed.

Prototype

// Not applicable in JS

Prototype

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