trq_first_msg()

trq_first_msg()#

Retrieves the first message in the queue associated with the given tr_queue instance.

Prototype

q_msg trq_first_msg(
    tr_queue trq
);

Parameters

Key

Type

Description

trq

tr_queue

The queue instance from which to retrieve the first message.


Return Value

A q_msg handle to the first message in the queue, or NULL if the queue is empty.

Notes

Use trq_next_msg() to iterate through subsequent messages in the queue.

Prototype

// Not applicable in JS

Prototype

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