trmsg_record_instances()

`trmsg_record_instances()`#

trmsg_record_instances() retrieves a list of cloned instances associated with a specific message key from the given list.

C

Prototype

json_t *trmsg_record_instances(
    json_t      *list,
    const char  *key,
    json_t      *jn_filter  // owned
);

Parameters

Key	Type	Description
`list`	`json_t *`	The list containing the messages.
`key`	`const char *`	The key identifying the message whose instances are to be retrieved.
`jn_filter`	`json_t *`	A JSON object specifying filtering criteria for the instances. The caller owns this object.

Return Value

A JSON list of cloned instances matching the specified key and filter. The caller is responsible for decrementing the reference count of the returned object.

Notes

The returned list is a deep copy of the instances, ensuring that modifications do not affect the original data. The caller must manage the memory of the returned object by calling json_decref() when it is no longer needed.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

trmsg_record_instances()

trmsg_record_instances()#

`trmsg_record_instances()`#