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

`popLE` overloads

== Synopses

Declared in `<bdlcc_timequeue.h>`

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). 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. Note that `newMinTime` is only loaded if there are items remaining in the time queue; therefore, `newLength` should be specified and examined to determine whether items remain, and `newMinTime` used only when `newLength > 0`. 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`.


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

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-01.adoc[_» more..._]#

Remove from this queue up to the specified `maxTimers` number of 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). 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. The behavior is undefined unless `maxTimers >= 0`. Note that `newMinTime` is only loaded if there are items remaining in the time queue; therefore, `newLength` should be specified and examined to determine whether items remain, and `newMinTime` used only when `newLength > 0`. Also note that if `DATA` follows the `bdema` allocator model, the allocator of the `buffer` vector is used to supply memory. Note finally that all the items appended into `buffer` have a time value less than or equal to the elements remaining in this queue.


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

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-06.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-07.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    xref:bsl/vector-00d.adoc[bsl::vector<TimeQueueItem<DATA>>]* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-07.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-08.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    std::pmr::vector<TimeQueueItem<DATA>>* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-08.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-03.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    std::vector<TimeQueueItem<DATA>>* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-03.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0d.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    int maxTimers,
    xref:bsl/vector-00d.adoc[bsl::vector<TimeQueueItem<DATA>>]* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0d.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0f.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    int maxTimers,
    std::pmr::vector<TimeQueueItem<DATA>>* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0f.adoc[_» more..._]#

Same as the preceding overload, appending removed items to the specified `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0a.adoc[popLE](
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& time,
    int maxTimers,
    std::vector<TimeQueueItem<DATA>>* buffer,
    int* newLength = 0,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval]* newMinTime = 0);
----

[.small]#xref:BloombergLP/bdlcc/TimeQueue-09c/popLE-0a.adoc[_» more..._]#


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