trmsg_active_records()

trmsg_active_records()#

trmsg_active_records() returns a list of cloned active records from the given list, applying the optional filter jn_filter.

Prototype

json_t *trmsg_active_records(
    json_t *list,
    json_t *jn_filter  // owned
);

Parameters

Key

Type

Description

list

json_t *

The list containing messages from which active records will be retrieved.

jn_filter

json_t *

An optional filter to apply when selecting active records. The caller owns this parameter.


Return Value

A list of cloned active records. The caller owns the returned value and must decrement its reference when done.

Notes

The returned list contains cloned records, making it safe for modification. The caller is responsible for managing the memory of the returned value.

Prototype

// Not applicable in JS

Prototype

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