Open topic with navigation

TIBCO Rendezvous® 8.7.0

# TibrvQueue::timedDispatch()

Method

## Declaration

    virtual TibrvStatus timedDispatch(tibrv_f64 timeout);

## Purpose

Dispatch an event, but if no event is ready to dispatch, limit the time that this call blocks while waiting for an event.

## Remarks

If an event is already in the queue, this call dispatches it, and returns immediately. If the queue is empty, this call waits for an event to arrive. If an event arrives before the waiting time elapses, then it dispatches the event and returns. If the waiting time elapses first, then the call returns without dispatching an event.

When the call dispatches an event, it returns the status code `TIBRV_OK`. When the call does not dispatch an event, it returns the status code `TIBRV_TIMEOUT`.

Parameter | Description
`timeout` | Maximum time (in seconds) that this call can block while waiting for an event to arrive in the queue. `TIBRV_NO_WAIT` (zero) indicates no blocking (immediate timeout). `TIBRV_WAIT_FOREVER` (-1) indicates no timeout.

## See Also

TibrvDispatchable

TibrvDispatchable::timedDispatch()

TibrvQueue::dispatch()

TibrvQueue::poll()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.