Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext
object::reserve

Increase the capacity to at least a certain amount.

Synopsis
void
reserve(
    std::size_t new_capacity);
Description

This increases the capacity() to a value that is greater than or equal to new_capacity. If new_capacity > capacity(), new memory is allocated. Otherwise, the call has no effect. The number of elements and therefore the size() of the container is not changed.

If new memory is allocated, all iterators including any past-the-end iterators, and all references to the elements are invalidated. Otherwise, no iterators or references are invalidated.

Complexity

Constant or average case linear in size(), worst case quadratic.

Exception Safety

Strong guarantee. Calls to memory_resource::allocate may throw.

Parameters

Name

Description

new_capacity

The new minimum capacity.

Exceptions

Type

Thrown On

std::length_error

new_capacity > max_size()


PrevUpHomeNext