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 a snapshot of the master branch, built from commit 064f557086.

url_base::reserve

Adjust the capacity without changing the size.

Synopsis

void
reserve(
    std::size_t n);

Description

This function adjusts the capacity of the container in characters, without affecting the current contents. Has no effect if n <= this->capacity().

Exception Safety

Strong guarantee. Calls to allocate may throw.

Exceptions

Type	Thrown On
`bad_alloc`	Allocation failure

Parameters

Name	Description
`n`	The capacity in characters, excluding any null terminator.