[#BloombergLP-bdlcc-SingleProducerQueue-popFront]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/SingleProducerQueue.adoc[SingleProducerQueue]::popFront
:relfileprefix: ../../../
:mrdocs:

Remove the front element and load it into the specified `value`&period;

== Synopsis

Declared in `&lt;bdlcc&lowbar;singleproducerqueue&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
popFront(TYPE* value);
----

== Description

Remove the element from the front of this queue and load that element into the specified `value`&period; If the queue is empty, block until it is not empty&period; Return 0 on success, and a non&hyphen;zero value otherwise&period; Specifically, return `e&lowbar;DISABLED` if `isPopFrontDisabled()`&period; On failure, `value` is not changed&period; Threads blocked due to the queue being empty will return `e&lowbar;DISABLED` if `disablePopFront` is invoked&period;

== Return Value

0 on success, and a non&hyphen;zero value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *value*
| receives the removed element
|===


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