trq_get_by_rowid()

`trq_get_by_rowid()`#

trq_get_by_rowid() retrieves a message from the queue iterator using its row ID.

C

Prototype

q_msg trq_get_by_rowid(
    tr_queue  trq,
    uint64_t  rowid
);

Parameters

Key	Type	Description
`trq`	`tr_queue`	The queue instance from which to retrieve the message.
`rowid`	`uint64_t`	The row ID of the message to retrieve.

Return Value

Returns a q_msg handle to the retrieved message, or NULL if the message is not found.

Notes

The returned message remains owned by the queue and should not be freed manually.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python