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

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

== Synopsis

Declared in `<bdlcc_deque.h>`

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

== Description

Append the specified move‐insertable `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. If the container is modified,`item` is left in a valid but unspecified state, otherwise `item` is left unchanged. 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 move‐append
| *timeout*
| absolute time at which to stop waiting
|===


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