[#BloombergLP-bdlcc-TimeQueue-09c-popLE-01]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/TimeQueue-09c.adoc[TimeQueue]::popLE
:relfileprefix: ../../../
:mrdocs:

Remove all items with a time less than or equal to the specified `time`&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
popLE(xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time);
----

== Description

Remove from this queue all the items that have a time value less than or equal to the specified `time`, and optionally append into the optionally specified `buffer` a list of the removed items, ordered by their corresponding time values (top item first)&period; Optionally load into the optionally specified `newLength` the number of items remaining in this queue, and into the optionally specified `newMinTime` the lowest remaining time value in this queue&period; Note that `newMinTime` is only loaded if there are items remaining in the time queue&semi; therefore, `newLength` should be specified and examined to determine whether items remain, and `newMinTime` used only when `newLength &gt; 0`&period; Also note that if `DATA` follows the `bdema` allocator model, the allocator of the `buffer` vector is used to supply memory for the items appended to the `buffer`&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *time*
| time threshold for removing items
|===


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