[#BloombergLP-bdlcc-Queue-tryPopBack-05]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/Queue.adoc[Queue]::tryPopBack
:relfileprefix: ../../../
:mrdocs:

`tryPopBack` overloads

== Synopses

Declared in `<bdlcc_queue.h>`

Remove up to the specified `maxNumItems` from the back of this queue. Optionally specify a `buffer` into which the items removed from the queue are loaded. If `buffer` is non‐null, the removed items are appended to it as if by repeated application of `buffer‐>push_back(popBack())` while the queue is not empty and `maxNumItems` have not yet been removed. This method never blocks. The behavior is undefined unless `maxNumItems >= 0`. Note that the ordering of the items in `*buffer` after the call is the reverse of the ordering they had in the queue.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/Queue/tryPopBack-02.adoc[tryPopBack](int maxNumItems);
----

[.small]#xref:BloombergLP/bdlcc/Queue/tryPopBack-02.adoc[_» more..._]#

If this queue is non‐empty, remove the last item, load that item into the specified `buffer`, and return 0 indicating success. If this queue is empty, return a non‐zero value with no effect on `buffer` or the state of this queue. This method never blocks.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlcc/Queue/tryPopBack-0d.adoc[tryPopBack](TYPE* buffer);
----

[.small]#xref:BloombergLP/bdlcc/Queue/tryPopBack-0d.adoc[_» more..._]#

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/Queue/tryPopBack-09.adoc[tryPopBack](
    int maxNumItems,
    xref:bsl/vector-00d.adoc[bsl::vector<TYPE>]* buffer);
----

[.small]#xref:BloombergLP/bdlcc/Queue/tryPopBack-09.adoc[_» more..._]#

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/Queue/tryPopBack-08.adoc[tryPopBack](
    int maxNumItems,
    std::pmr::vector<TYPE>* buffer);
----

[.small]#xref:BloombergLP/bdlcc/Queue/tryPopBack-08.adoc[_» more..._]#

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/Queue/tryPopBack-0e.adoc[tryPopBack](
    int maxNumItems,
    std::vector<TYPE>* buffer);
----

[.small]#xref:BloombergLP/bdlcc/Queue/tryPopBack-0e.adoc[_» more..._]#


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