[#BloombergLP-bdlcc-Deque-timedPushFront-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/Deque.adoc[Deque]::timedPushFront
:relfileprefix: ../../../
:mrdocs:

Timed append of `item` to the front of this container.

== Synopsis

Declared in `<bdlcc_deque.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
timedPushFront(
    TYPE const& item,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& timeout);
----

== Description

Append the specified `item` to the front of this container if space is available, otherwise (if the container is full) block waiting for space to become available or until the specified `timeout` (expressed as the *ABSOLUTE* time from 00:00:00 UTC, January 1, 1970) expires. Return 0 if space was or became available and this container was updated, and a non‐zero value if the call timed out before space became available and this container was left unmodified. Note that this method can block indefinitely if another thread has the mutex locked, particularly by a proctor object ‐‐ there is no guarantee that this method will return after `timeout`.

== Return Value

0 if the container was updated, and a non‐zero value if timed out

== Parameters

[cols="1,4"]
|===
| Name| Description
| *item*
| value to append
| *timeout*
| absolute time at which to stop waiting
|===


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