[#BloombergLP-bdlcc-Deque-timedPushBack-0c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/Deque.adoc[Deque]::timedPushBack
:relfileprefix: ../../../
:mrdocs:

Timed move&hyphen;append of `item` to the back of this container&period;

== Synopsis

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

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

== Description

Append the specified move&hyphen;insertable `item` to the back 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&colon;00&colon;00 UTC, January 1, 1970) expires&period; If the container is modified, `item` is left in a valid but unspecified state, otherwise `item` is unchanged&period; Return 0 if space was or became available and this container was updated, and a non&hyphen;zero value if the call timed out before space became available and this container was left unmodified&period; Note that this method can block indefinitely if another thread has the mutex locked, particularly by a proctor object &hyphen;&hyphen; there is no guarantee that this method will return after `timeout`&period;

== Return Value

0 if the container was updated, and a non&hyphen;zero value if timed out

== Parameters

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


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