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

`tryPopBack` overloads

== Synopses

Declared in `<bdlcc_deque.h>`

Remove up to the specified `maxNumItems` from the back of this container. Optionally specify a `buffer` into which the items removed from the container 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 container is not empty and `maxNumItems` have not yet been removed. Note that the ordering of the items in `*buffer` after the call is the reverse of the ordering they had in the deque. Also note that `*buffer` is not cleared ‐‐ the popped items are appended after any pre‐existing contents.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlcc/Deque/tryPopBack-0e.adoc[tryPopBack](xref:BloombergLP/bdlcc/Deque/size_type.adoc[size_type] maxNumItems);
----

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

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlcc/Deque/tryPopBack-06.adoc[tryPopBack](TYPE* item);
----

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

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


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

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

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


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

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

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


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

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


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