:relfileprefix: ../../../
[#boost-urls-url_base-reserve]

= xref:boost.adoc[pass:[boost]]::xref:boost/urls.adoc[pass:[urls]]::xref:boost/urls/url_base.adoc[pass:[url_base]]::reserve


Adjust the capacity without changing the size


== Synopsis

Declared in header `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/url_base.hpp#L188[boost/url/url_base.hpp,window=blank_]>`

[source,cpp,subs="verbatim,macros,-callouts"]
----
void
reserve(xref:std.adoc[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&lt;&equals; this-&gt;capacity()`.

=== Exception Safety

Strong guarantee.
Calls to allocate may throw.



== Exceptions

|===
| Name | Thrown on

| `bad_alloc`
| 
Allocation failure

|===



== Parameters

|===
| Name | Description 

| *n*
| 
The capacity in characters,
excluding any null terminator.

|===