SourcePro C++ 12.0 |
SourcePro® C++ API Reference Guide |
SourcePro C++ Documentation Home |
Waits for the next IOU in a group of IOUs to become redeemable. More...
#include <rw/itc/RWTIOUTrap.h>
Public Member Functions | |
RWTIOUTrap (void) | |
RWTIOUTrap (RWStaticCtor) | |
RWTIOUTrap (const RWTIOUTrap< Redeemable > &second) | |
~RWTIOUTrap (void) | |
RWTIOUTrap< Redeemable > & | operator= (const RWTIOUTrap< Redeemable > &second) |
bool | isEmpty (void) const |
void | setTrap (RWTIOUResult< Redeemable > iou) const |
RWTIOUResult< Redeemable > | getNext (void) |
RWWaitStatus | getNext (RWTIOUResult< Redeemable > &iouResult, unsigned long milliseconds) |
bool | tryGetNext (RWTIOUResult< Redeemable > &iouResult) |
Protected Member Functions | |
RWTIOUTrapImp< Redeemable > & | body (void) const |
RWTIOUTrap<Redeemable> allows you to wait for the next IOU in a group of IOUs to become redeemable. For example, it can be used to wait on IOU results from a number of RWThreadIOUFunction instances. You may either block waiting for the next IOU to become available, wait with a time-out, or poll for the next IOU.
RWTIOUTrap<Redeemable> assists in the management of a number of RWTIOUResult instances. Without an IOU trap, you would have to poll each of a number of IOUs in turn, testing to see when the next one becomes redeemable. This kind of polling loop, however, is inefficient in a multithreaded environment. With an IOU trap, you merely wait for the trap to provide you with the next redeemable IOU.
Each IOU you wish to trap must first be registered using the setTrap() member function. Once an IOU is registered, it automatically notifies the trap when it becomes redeemable. RWTIOUTrap<Redeemable> uses a producer-consumer queue to store each IOU as it notifies the trap that it is redeemable. An RWTIOUResult<Redeemable> is inserted into the queue by the thread that closed it, and taken off the queue when the trap's getNext() member is called.
The IOU trap is implemented as a handle-body object. The RWTIOUTrap<Redeemable> is the handle for an IOU trap object. These handles can be passed and shared by value. The actual trap object is deleted when the last handle that references it is destroyed.
#include <iostream> #include <rw/itc/RWTIOUTrap.h> RWTIOUTrap<long> iouTrap; RWTIOUResult<long> result1 = ...; RWTIOUResult<long> result2 = ...; RWTIOUResult<long> result3 = ...; iouTrap.setTrap(result1); iouTrap.setTrap(result2); iouTrap.setTrap(result3); for (int i; i < 3; i++) { long l = iouTrap.getNext(); std::cout << "next result = " << l << std::endl; }
RWTIOUTrap< Redeemable >::RWTIOUTrap | ( | void | ) | [inline] |
Constructs an RWTIOUTrap<Redeemable> instance bound to a new RWTIOUTrapImp<Redeemable> instance.
RWTIOUTrap< Redeemable >::RWTIOUTrap | ( | RWStaticCtor | ) | [inline] |
Constructs a static RWTIOUTrap<Redeemable> handle instance. This constructor does not construct an RWTIOUTrapImp<Redeemable> instance, and does not change the handle instance.
RWTIOUTrap< Redeemable >::RWTIOUTrap | ( | const RWTIOUTrap< Redeemable > & | second | ) | [inline] |
Copy constructor. Constructs a new handle instance and attaches it to the trap instance, if any, pointed to by second, and increments the trap's reference count.
RWTIOUTrap< Redeemable >::~RWTIOUTrap | ( | void | ) | [inline] |
Destroys the handle and decrements the reference count of the current trap instance, if any, deleting the trap if its reference count equals zero.
RWTIOUTrapImp< Redeemable > & RWTIOUTrap< Redeemable >::body | ( | void | ) | const [inline, protected] |
Gets a reference for the body instance, if any.
RWTHRInvalidPointer | Thrown if this handle is not attached to a body. |
Reimplemented from RWHandleBase.
RWWaitStatus RWTIOUTrap< Redeemable >::getNext | ( | RWTIOUResult< Redeemable > & | iouResult, | |
unsigned long | milliseconds | |||
) | [inline] |
Gets the next redeemable RWTIOUResult<Redeemable> , and if none are ready, waits until one becomes available. Returns with RW_THR_TIMEOUT status if an IOU becomes redeemable within the specified number of milliseconds; otherwise the returned status is RW_THR_COMPLETED.
RWTIOUResult< Redeemable > RWTIOUTrap< Redeemable >::getNext | ( | void | ) | [inline] |
Gets the next redeemable RWTIOUResult<Redeemable> , and if none are ready, waits until one becomes available.
bool RWTIOUTrap< Redeemable >::isEmpty | ( | void | ) | const [inline] |
Returns true
if the queue is empty, otherwise returns false
.
RWTIOUTrap< Redeemable > & RWTIOUTrap< Redeemable >::operator= | ( | const RWTIOUTrap< Redeemable > & | second | ) | [inline] |
Detaches this handle from its current trap instance, if any, decrementing the trap's reference count and deleting the trap if the count equals zero. It then attaches to the trap instance, if any, pointed by second, and increments the new trap's reference count.
void RWTIOUTrap< Redeemable >::setTrap | ( | RWTIOUResult< Redeemable > | iou | ) | const |
Traps the given IOU when it becomes redeemable.
bool RWTIOUTrap< Redeemable >::tryGetNext | ( | RWTIOUResult< Redeemable > & | iouResult | ) | [inline] |
Gets next redeemable RWTIOUResult<Redeemable> if one is available. If an IOU has already been trapped, returns true
and assigns the redeemable IOU to the iouResult argument, otherwise returns false
.
© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.