[#boost-urls-url_base-reserve]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/url_base.adoc[url_base]::reserve
:relfileprefix: ../../../
:mrdocs:


Adjust the capacity without changing the size

== Synopsis


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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
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


|===
| Name | Thrown on

| `bad_alloc`
| Allocation failure


|===

== Parameters


|===
| Name | Description

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


|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#