std::deque::shrink_to_fit

void shrink_to_fit();

Requests the removal of unused capacity.

It is a non-binding request to reduce capacity to size(). It depends on the implementation if the request is fulfilled.

All iterators and references are potentially invalidated. Past-the-end iterator is also potentially invalidated.

Parameters

(none).

Return value

(none).

Complexity

At most linear in the size of the container.

Example

#include <deque>
 
int main() {
    std::deque<int> nums(1000, 42);
    nums.push_front(1);
    nums.pop_front();
 
    nums.clear();
 
    // nums now contains no items, but it may still be holding allocated memory. 
    // Calling shrink_to_fit will free any unused memory.
    nums.shrink_to_fit();
}

See also