[#bsl-list-054-max_size]
= xref:bsl.adoc[bsl]::xref:bsl/list-054.adoc[list]::max&lowbar;size
:relfileprefix: ../../
:mrdocs:

Return an upper bound on the largest number of elements this list can hold&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;list&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/list-054/size_type.adoc[list&lt;VALUE, ALLOCATOR&gt;::size&lowbar;type]
max&lowbar;size() const noexcept;
----

== Description

Note that the return value of this function does not guarantee that this list can successfully grow that large, or even close to that large without running out of resources&period;

== Return Value

maximum number of elements this list can hold


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