RWTPCValStackGuarded<Type>

Module:  Threads   Package:  Interthread Communication

RWTPCValStackGuarded<Type>  
   RWTPCValBufferBaseGuarded<Type,RWGuardedDecorator<Type>>

• Local Index
• Header File
• Description
• Example
• Public Constructor
• Public Destructor
• See Also

Members

RWTPCValStackGuarded()

~RWTPCValStackGuarded()

#include <rw/itc/RWTPCValStackGuarded.h> 

RWTPCValStackGuarded<Type> is a last-in-first-out (LIFO) stack that provides producer-consumer synchronization semantics for exchanging guarded values between cooperating threads.

In the producer-consumer synchronization model, reader threads (consumers) are blocked while the stack is empty, and writer threads (producers) are blocked while the stack is full. The stack is considered full when the number of unread entries equals or exceeds some user-specified maximum capacity.

The write operations inherited by this class bind a guard functor to each value prior to storing that value in an internal buffer. A guard functor is used during read operations to determine whether the associated value is currently eligible for retrieval from the buffer.

See the example given under RWTPCValQueueGuarded<Type>.

RWTPCValStackGuarded(size_t maxCapacity=0,
                    bool isOpen=true);

Constructs a value-based, guarded, producer-consumer stack instance.

The parameter maxCapacity specifies the maximum number of unread entries allowed to accumulate within the stack. Once the number of entries in the stack equals this number, any thread attempting to write an additional entry is blocked until an entry is removed by a read operation, or until the capacity is increased. A capacity of zero, the default, is used to indicate that the stack has no size limit, except as imposed by memory limitations, and that all write operations should complete without blocking.

The parameter isOpen is a bool value that specifies whether the stack should be initialized in the open state (true, the default) or the closed state (false).

~RWTPCValStackGuarded();

Destructor.

RWTPCValBufferBaseGuarded<Type,GuardDecorator>, RWTPCValStack<Type>, RWTPCValQueueGuarded<Type>, RWTPCValStackGuardedPrioritized<Type>

© 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.