Rogue Wave banner
Previous fileTop of DocumentContentsIndexNext file

RWTPCValStackGuardedPrioritized<Type>


RWTPCValStackGuardedPrioritized<Type> RWTPCValBufferBaseGuardedPrioritized<Type,RWTGuardAndPriorityDecorator<Type>>

Data Type and Member Function Indexes
(exclusive of constructors and destructors)

None

Package

Interthread Communication

Header File

#include <rw/itc/RWTPCValStackGuardedPrioritized.h> 

Description

RWTPCValStackGuardedPrioritized<Type> is a last-in-first-out (LIFO) stack that provides producer-consumer synchronization semantics for exchanging guarded and prioritized 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 and priority value to each data value prior to storing that value in an internal buffer. The guard functor is used during read operations to determine whether the associated value is currently eligible for retrieval from the buffer. The priority value is used during write operations to determine a value's insertion point within the stack, such that the set of unread values will be retrieved in priority order when they are eventually read from the queue. A new value is retrieved before any previously inserted values of the same priority, except when the retrieval of the newer values is prohibited by their guard functors.

Example

See the example given under RWTPCValQueueGuardedPrioritized<Type>.

Public Constructor

RWTPCValStackGuardedPrioritized(size_t maxCapacity=0,
                                RWBoolean isOpen=TRUE);

See Also

RWTPCValBufferBaseGuardedPrioritized<...>, RWTPCValStackGuarded<Type>, RWTPCValStackPrioritized<Type>, RWTPCValQueueGuardedPrioritized<Type>



Previous fileTop of DocumentContentsIndexNext file

©Copyright 2000, Rogue Wave Software, Inc.
Contact Rogue Wave about documentation or support issues.