TibrvQueueGroup

Class

Declaration

class TibrvQueueGroup : public TibrvDispatchable
    TibrvQueueGroup();             // Create empty.
    virtual ~TibrvQueueGroup();    // Destroy and reclaim storage.

Purpose

Prioritized dispatch of several queues with one call.

Remarks

Queue groups add flexibility and fine-grained control to the event queue dispatch mechanism. Programs can create groups of queues and dispatch them according to their queue priorities.

The constructor creates a hollow object; TibrvQueueGroup::create() makes it operational.

The destructor calls the destroy method, unless the C object is already destroyed.

Method	Description
Life Cycle
TibrvQueueGroup::create()	Create an event queue group.
TibrvQueueGroup::destroy()	Destroy an event queue group.
TibrvQueueGroup::getHandle()	Extract the C handle of this queue group.
TibrvQueueGroup::isValid()	Test validity of a queue group.
Dispatch
TibrvQueueGroup::dispatch()	Dispatch an event from a queue group; if no event is ready, block.
TibrvQueueGroup::poll()	Dispatch an event, but if no event is ready to dispatch, return immediately (without blocking).
TibrvQueueGroup::timedDispatch()	Dispatch an event, but if no event is ready to dispatch, limit the time that this call blocks while waiting for an event.
Queues
TibrvQueueGroup::add()	Add an event queue to a queue group.
TibrvQueueGroup::remove()	Remove an event queue from a queue group.

Inherited Methods
TibrvDispatchable::getDispatchable() TibrvDispatchable::destroy() TibrvDispatchable::dispatch() TibrvDispatchable::isValid() TibrvDispatchable::poll() TibrvDispatchable::timedDispatch()

Related Classes

TibrvDispatchable

TibrvQueue