std::{{{1}}}::shrink_to_fit
From cppreference.com
| void shrink_to_fit(); |
||
Requests the removal of unused capacity.
It is a non-binding request to reduce the memory usage without changing the size of the sequence. It depends on the implementation whether the request is fulfilled.
| Information on iterator invalidation is copied from here |
Contents |
Parameters
(none)
| Type requirements | ||
-T must meet the requirements of MoveInsertable.
|
Return value
(none)
Complexity
At most linear in the size of the container.
Exceptions
If an exception is thrown other than by T's move constructor, there are no effects.
Notes
In libstdc++, shrink_to_fit() is not available in C++98 mode.
Example
| Templated content. The link is cpp/container/<PP>/example_shrink_to_fit |
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 850 | C++98 | std:: lacked explicit shrink-to-fit operations
|
provided |
See also
| returns the number of elements (public member function of std::{{{1}}})
|
