Open topic with navigation

TIBCO Rendezvous® 8.8.0

# TibrvQueueGroup::poll()

Method

## Declaration

    virtual TibrvStatus poll();

## Purpose

Dispatch an event, but if no event is ready to dispatch, return immediately (without blocking).

## Remarks

If any queue in the group contains an event, then this call searches the queues in priority order, dispatches an event from the first non-empty queue that it finds, and then returns. If all the queues are empty, then this call returns immediately.

When searching the group for a non-empty queue, this call searches according to the priority values of the queues. If two or more queues have identical priorities, subsequent dispatch and poll calls rotate through them in round-robin fashion.

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.

This call is equivalent to `timedDispatch(0)`.

## See Also

TibrvDispatchable

TibrvDispatchable::poll()

TibrvQueueGroup::dispatch()

TibrvQueueGroup::timedDispatch()

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-2025. Cloud Software Group, Inc. All Rights Reserved.