This class provides a thread‐safe unbounded queue of values that assumes a single producer thread.

Synopsis

Declared in <bdlcc_singleproducerqueueimpl.h>

template<
    class TYPE,
    class ATOMIC_OP,
    class MUTEX,
    class CONDITION>
class SingleProducerQueueImpl;

Description

The types ATOMIC_OP, MUTEX, and CONDITION are exposed for testing. Typical usage is with bsls::AtomicOperations for ATOMIC_OP, bslmt::Mutex for MUTEX, and bslmt::Condition for CONDITION.

Type Aliases

Name

Description

value_type

The type for elements stored in this queue.

Enums

Name

Description

Unnamed enum

Status codes returned by queue operations.

Member Functions

Name

Description

SingleProducerQueueImpl [constructor]

Constructors

~SingleProducerQueueImpl [destructor]

Destroy this object.

allocator

Return the allocator used by this object to supply memory.

disablePopFront

Disable dequeueing from this queue.

disablePushBack

Disable enqueueing into this queue.

enablePopFront

Enable dequeueing. If the queue is not dequeue disabled, this call has no effect.

enablePushBack

Enable queuing. If the queue is not enqueue disabled, this call has no effect.

isEmpty

Return true if this queue is empty (has no elements), or false otherwise.

isFull

Return true if this queue is full (has no available capacity), or false otherwise. Note that for unbounded queues, this method always returns false.

isPopFrontDisabled

Return true if this queue is dequeue disabled, and false otherwise. Note that the queue is created in the "dequeue enabled" state.

isPushBackDisabled

Return true if this queue is enqueue disabled, and false otherwise. Note that the queue is created in the "enqueue enabled" state.

numElements

Returns the number of elements currently in this queue.

popFront

Remove the element from the front of this queue and load that element into the specified value.

pushBack

pushBack overloads

removeAll

Remove all items currently in this queue.

tryPopFront

Attempt to remove the front element of this queue without blocking.

tryPushBack

tryPushBack overloads

waitUntilEmpty

Block until all the elements in this queue are removed.

operator BloombergLP::bslmf::NestedTraitDeclaration<SingleProducerQueueImpl, UsesBslmaAllocator>

Declare that this type uses a bslma allocator.

Friends

Name

Description

BloombergLP::bdlcc::SingleProducerQueueImpl_PopCompleteGuard

This class implements a guard automatically invokes popComplete on a NODE upon destruction.

BloombergLP::bdlcc::SingleProducerQueueImpl_ReleaseAllRawProctor

This class implements a proctor that, unless its release method has previously been invoked, automatically invokes releaseAllRaw on a TYPE upon destruction.

Created with MrDocs