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 |
---|---|---|
|
|
The list containing messages from which active records will be retrieved. |
|
|
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