array::shrink_to_fit

Request the removal of unused capacity.

Synopsis

void
shrink_to_fit() noexcept;

Description

This performs a non-binding request to reduce the capacity to the current size. The request may or may not be fulfilled. If reallocation occurs, all iterators including any past-the-end iterators, and all references to the elements are invalidated. Otherwise, no iterators or references are invalidated.

Complexity

At most, linear in size().

Exception Safety

No-throw guarantee.