[#BloombergLP-bdlcc-Queue-queue]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/Queue.adoc[Queue]::queue
:relfileprefix: ../../../
:mrdocs:

Return a reference to the modifiable underlying `bdlc::Queue` object.

== Synopsis

Declared in `<bdlcc_queue.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bdlc/Queue.adoc[bdlc::Queue<TYPE>]&
queue();
----

== Description

Return a reference to the modifiable underlying `bdlc::Queue` object used by this queue. Any access to the returned queue MUST first lock the associated mutex object (see the `mutex` method) in a multi‐threaded environment. And when items are directly added to the queue returned by this method, the associated condition variable (see the `condition` method) should be signaled to notify any waiting threads of the availability of the new data.

The (error‐prone) usage of this method will be replaced by an appropriate smart‐pointer‐like proctor object in the future. Meanwhile, use this method with caution.

== Return Value

reference to the underlying `bdlc::Queue` object


[.small]#Created with https://www.mrdocs.com[MrDocs]#