BloombergLP::bdlcc::SingleConsumerQueueImpl

Synopsis

Declared in <bdlcc_singleconsumerqueueimpl.h>

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

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
`SingleConsumerQueueImpl` [constructor]	Constructors
`~SingleConsumerQueueImpl` [destructor]	Destroy this container. The behavior is undefined unless all access or modification of the container has completed prior to this call.
`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`	Return the number of elements currently in this queue.
`popFront`	Remove the front element into `value`, blocking until available.
`pushBack`	`pushBack` overloads
`removeAll`	Remove all items currently in this queue.
`tryPopFront`	Attempt to remove the front element without blocking.
`tryPushBack`	`tryPushBack` overloads
`waitUntilEmpty`	Block until all elements in this queue are removed.
`operator BloombergLP::bslmf::NestedTraitDeclaration<SingleConsumerQueueImpl, UsesBslmaAllocator>`	Declare that this type uses a `bslma` allocator.

Friends

Name	Description
`BloombergLP::bdlcc::SingleConsumerQueueImpl_AllocateLockGuard`	This class implements a guard that automatically invokes `releaseAllocateLock` on the managed queue upon destruction.
`BloombergLP::bdlcc::SingleConsumerQueueImpl_PopCompleteGuard`	This class implements a guard that automatically invokes `popComplete` on the managed queue upon destruction.
`BloombergLP::bdlcc::SingleConsumerQueueImpl_MarkReclaimProctor`	This class implements a proctor that, unless its `release` method has previously been invoked, automatically invokes `markReclaim` on a `NODE` upon destruction.